Qt 專案遷移錯誤：無法建立建置目錄，刪除 .pro.user 即可解決

錯誤現象

將 Qt 專案從其他電腦複製過來後，Qt Creator 建置失敗，輸出：

Could not create directory "C:\Users\Administrator\Documents\Qt\build-starplayer-Desktop_Qt_5_4_2_MinGW_32bit-Debug"
Error while building/deploying project starplayer (kit: Desktop Qt 5.4.2 MinGW 32bit)
When executing step "qmake"

根本原因

.pro.user 檔案儲存了上一台電腦的建置路徑、Kit 設定、偵錯參數等機器相關資訊。新環境路徑不一致導致 qmake 無法建立目錄。

解決步驟

1. 關閉 Qt Creator。
2. 在專案根目錄下找到 *.pro.user 檔案（可能有多個，如 starplayer.pro.user、starplayer.pro.user.1A2B3C）。
3. 全部刪除或備份後移除。
4. 重新開啟專案，Qt Creator 會自動偵測當前 Kit 並重新產生乾淨的 .pro.user。

補充說明

• 不影響原始碼：.pro.user 僅為 IDE 使用者設定，不包含任何專案邏輯。
• 版控忽略：.gitignore / .svnignore 應包含 *.pro.user*，避免提交造成團隊衝突。
• Shadow Build：Qt Creator 預設使用影子建置，建置目錄與原始碼分離，路徑包含 Kit 名稱，跨機器遷移必須重置。

常見同類問題

跨電腦遷移 Qt 專案時，「刪除 .pro.user」是標準作業動作，能解決 90% 以上的建置路徑問題。