這篇文章的背景
媽媽的電腦要重裝系統，與其每次手動點下一步，不如做一個「USB 插上就全自動」的安裝盤。理論上很簡單：準備一個
媽媽的電腦要重裝系統，與其每次手動點下一步，不如做一個「USB 插上就全自動」的安裝盤。理論上很簡單：準備一個
autounattend.xml，放進 USB 根目錄，Windows 安裝程序就會自動讀取。但實際操作下來，光是 XML 就踩了兩個坑，bat 腳本又踩了三個，Python 操作 USB 還踩了一個。這篇文章把每一個坑都記錄下來，讓你不用重複走我走過的路。
坑 1
autounattend.xml 第 18 行報錯 ── 命名空間聲明缺失
實際錯誤信息（Windows 安裝程序彈窗）
Windows安装程序无法分析或处理无人参与应答文件 [D:\autounattend.xml]。在应答文件的第18行第9列检测到该错误。
根本原因
文件第 2 行的根標籤
<unattend> 缺少 xmlns:wcm 命名空間聲明。文件裡用到了 wcm:action="add"，但 XML 解析器不認識 wcm 前綴是什麼。第一次碰到 wcm:action 的地方（第 18 行）就直接報錯。
錯誤的寫法
<unattend xmlns=
"urn:schemas-microsoft-com:unattend">
正確的寫法
<unattend
xmlns="urn:schemas-microsoft-com:unattend"
xmlns:wcm="http://schemas.microsoft.com/
WMIConfig/2002/State"
xmlns:xsi="http://www.w3.org/
2001/XMLSchema-instance">
完整正確寫法（複製即用）
三行缺一不可，一個字母都不能錯：
autounattend.xml — 根標籤（前 3 行）
<unattend
xmlns="urn:schemas-microsoft-com:unattend"
xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
XML 解析器讀到第 2 行時，看到根標籤只聲明了預設命名空間，它會先記下來繼續往下讀。一直讀到第 18 行，第一次碰到有前綴的屬性
wcm:action，才發現根本不知道 wcm 是什麼。所以報錯位置永遠是第一個用到 wcm: 的地方，真正的問題在第 2 行。
坑 2
ProductKey 設置無法讀取 ── 缺少 <Key> 標籤
實際錯誤信息
Windows无法从无人参与应答文件读取<ProductKey>设置
根本原因
<ProductKey> 段落裡只有 <WillShowUI>，沒有 <Key> 值。Windows 安裝程序不知道要裝哪個版本（家庭版/專業版），所以報錯停下來。
錯誤的寫法（缺少 Key）
<ProductKey>
<WillShowUI>OnError</WillShowUI>
</ProductKey>
正確的寫法（必須有 Key）
<ProductKey>
<Key>YTMG3-N6DKC-DKB77-...</Key>
<WillShowUI>Never</WillShowUI>
</ProductKey>
通用安裝金鑰（Generic Key）只是告訴安裝程序「我要裝哪個版本」，它本身不具備激活功能。如果你的電腦主板有數字許可證（Digital License），裝完後 Windows 會自動聯網激活，不需要輸入任何激活碼。
常用通用安裝金鑰
選對版本就好，金鑰本身免費公開：
| 版本 | 通用安裝金鑰 | 適用對象 |
|---|---|---|
| Windows 11 / 10 家庭版 Home | YTMG3-N6DKC-DKB77-7M9GH-8HVX7 | 一般家用電腦 |
| Windows 11 / 10 專業版 Pro | VK7JG-NPHTM-C97JM-9MPGT-3V66T | 商務/進階功能 |
坑 3
.bat 腳本點開黑框一閃而過 ── 三個連環原因
現象描述
雙擊
auto-install-software.bat，黑框出現 → 顯示一些文字 → 按任意鍵 → 立刻消失，什麼都沒裝。
這個問題有三個疊加原因，需要逐一排查：
原因 A
沒有以管理員身份運行
為什麼需要管理員權限
腳本裡的系統優化命令（修改 Windows 服務、設定電源計劃、關閉 Defender 等）都需要管理員權限。如果普通用戶運行，這些命令會靜默失敗 ── 不會報錯，只是什麼都不做，然後腳本繼續往下跑，跑完就退出了。
解決方法
右鍵點 .bat 文件 → 選「以管理員身份運行」。不要雙擊，要右鍵。
原因 B
腳本混入了 Linux 語法
>/dev/null
問題說明
在 Linux/Mac 上，「靜默輸出」的寫法是
>/dev/null 2>&1。但 Windows CMD 裡根本沒有 /dev/null 這個東西。如果腳本用了這個語法，Windows 會把它當成真的嘗試重定向到 /dev/null 路徑，造成 winget 檢測邏輯失敗，腳本就跳到手動安裝提示，按任意鍵就退出了。
Linux 語法（Windows 不認識）
winget --version >/dev/null 2>&1
Windows 正確寫法
winget --version >nul 2>&1
原因 C
winget 在新裝 Windows 上未初始化
問題說明
剛裝好的 Windows 11，winget（Windows 包管理器）可能還沒加進 PATH，或者 App Installer 還沒完成初始化。直接用
where winget 找不到，腳本就報錯退出。
正確的 winget 三重備用檢測寫法
auto-install-software.bat — winget 檢測段落
:: 方法1：直接找（多數情況下夠用）
where winget >nul 2>&1
if %errorlevel% equ 0 goto :install
:: 方法2：完整路徑備用（winget 存在但不在 PATH）
if exist "%LOCALAPPDATA%\Microsoft\WindowsApps\winget.exe" (
set PATH=%PATH%;%LOCALAPPDATA%\Microsoft\WindowsApps
goto :install
)
:: 方法3：強制重新激活（剛裝好還未初始化）
powershell -Command "Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe" >nul 2>&1
timeout /t 15 /nobreak >nul
where winget >nul 2>&1
if %errorlevel% equ 0 goto :install
坑 4
USB 文件無法用記事本直接修改 ── 用 Python 繞過
現象描述
在 Windows 上用記事本打開 USB 裡的 .bat 或 .xml，修改後保存失敗，或者文件被鎖定無法寫入。USB 安裝盤的部分文件系統屬性導致直接寫入受限。
解決方法：用 Python 讀取修改後重寫
Python 直接讀取文件內容到記憶體，修改後重寫，繞過記事本的鎖定問題。
修改 autounattend.xml — 加入命名空間
# 讀取
content = open('F:/autounattend.xml', encoding='utf-8').read()
# 修改（加入正確的命名空間聲明）
content = content.replace(
'<unattend xmlns="urn:schemas-microsoft-com:unattend">',
'<unattend xmlns="urn:schemas-microsoft-com:unattend"'
' xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State"'
' xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">'
)
# 寫回（使用 Windows 換行格式 \r\n）
with open('F:/autounattend.xml', 'w',
encoding='utf-8', newline='\r\n') as f:
f.write(content)
如果在 bash 環境（Claude Code 的 Bash 工具）裡用 Python heredoc 寫 .bat 文件，bash 會自動把
>nul 改成 >/dev/null，然後你就回到了坑 3。正確做法是用 Python 字符串拼接，每一行都用單引號包裝，不讓 bash 解釋任何內容。
完整安裝流程
從零開始到媽媽電腦裝好所有軟件，共四個階段
準備階段（電腦上操作）
下載 Windows 11 ISO（Microsoft 官網）
下載 Rufus（免費 USB 製作工具）
準備 autounattend.xml（用本文模板，注意三個 xmlns）
準備 auto-install-software.bat（winget 安裝腳本）
↓
製作 USB 安裝盤
Rufus 選擇 ISO → 分區方案選 GPT → 目標系統 UEFI（非 CSM）
點「開始」寫入（USB 會被格式化，注意備份）
寫入完成後，把 autounattend.xml 複製到 USB 根目錄
把 auto-install-software.bat 複製到 USB 根目錄
↓
媽媽電腦安裝 Windows（全自動）
USB 插入媽媽電腦 → 重啟 → 開機按 F9（或 F12，視品牌而定）
選擇 USB 開機
全自動安裝（約 20 分鐘，中途無需操作）
自動進入桌面（無需設定帳號、密碼、語言）
↓
安裝常用軟件（bat 腳本）
USB 插入剛裝好的媽媽電腦
右鍵 auto-install-software.bat → 以管理員身份運行
連接 WiFi → 等待約 15 分鐘（winget 自動下載安裝）
完成！重啟電腦
快速排錯清單
出發前點一遍，省去回頭重做的麻煩
安裝前檢查（autounattend.xml）
autounattend.xml 根標籤有三個 xmlns 聲明？（xmlns、xmlns:wcm、xmlns:xsi 三個都要）
ProductKey 段落有 <Key> 標籤，並填入了通用安裝金鑰？
XML 文件編碼是 UTF-8，換行格式是 Windows（\r\n）？
autounattend.xml 放在 USB 根目錄（不是子資料夾裡）？
安裝前檢查（auto-install-software.bat）
.bat 文件所有靜默重定向是 >nul，不是 >/dev/null？
winget 檢測段落有三重備用方法（where / 完整路徑 / 強制激活）？
.bat 文件放在 USB 根目錄，不是從電腦 C:\ 的舊版本運行？
運行 .bat 前檢查
右鍵「以管理員身份運行」，不是直接雙擊？
電腦已連接 WiFi？（winget 需要下載，離線會失敗）
耐心等待，不要在黑框顯示進度時按任意鍵關掉？
FAQ
常見疑問
Q：通用安裝金鑰是盜版嗎？用了會被封號嗎？
完全合法，這是微軟官方公開的 Generic Key（通用金鑰）。它的唯一作用是告訴安裝程序「我要裝家庭版還是專業版」，本身沒有激活功能。如果你的電腦主板有數字許可證（OEM 激活或之前已激活過），裝完後 Windows 會自動聯網激活，和金鑰無關。
Q：autounattend.xml 放在 USB 根目錄，但安裝程序沒有自動讀取？
有幾個可能原因：（1）Rufus 製作時沒有選 GPT + UEFI 模式，導致安裝程序走了 Legacy BIOS 流程；（2）autounattend.xml 名字寫錯（大小寫、拼寫）；（3）開機時 USB 啟動優先級不對。確認三點：Rufus 選 GPT、XML 名字完全正確、BIOS 設定 USB 優先啟動。
Q：bat 腳本跑完了，但某些軟件沒裝上？
最常見原因是 winget 找不到那個軟件的 ID。可以先在腳本裡加一行
winget search 軟件名 找到正確 ID，再更新腳本。另一個原因是網速太慢，超時了。可以把 timeout /t 15 的等待時間加長。Q：裝完 Windows 進桌面後，還要做什麼才算「激活」？
連上 WiFi，等幾分鐘。Windows 會自動檢查主板上的數字許可證，如果有的話，右下角會出現激活成功的提示。你可以在「設定 → 系統 → 激活」頁面查看狀態。如果顯示「已使用數字許可證激活」，就完成了，什麼都不用做。
Q：我是 Claude Code 用戶，可以讓 AI 幫我生成 autounattend.xml 嗎？
可以。告訴 Claude 你要「生成一個 Windows 11 家庭版全自動安裝的 autounattend.xml，跳過所有手動步驟，自動創建本地帳號，時區設為 Pacific/Auckland（或你的時區）」。記得讓它加入本文提到的三個 xmlns 聲明。生成後，用本文的排錯清單核對一遍再放進 USB。