Qt 專案建置錯誤：「Could not start process qmake」完整解決方案

錯誤現象

執行 Qt Widget 專案時輸出：

Running steps for project qtNetTest...
Could not start process "F:\Qt_5.3\5.3\mingw482_32\bin\qmake.exe"
C:\ProjectFolder\qt_projects\qtNetTest\qtNetTest.pro -r -spec win32-g++ "CONFIG+=debug"
Error while building/deploying project qtNetTest (kit: Desktop Qt 5.3.0 MinGW 32bit)
When executing step 'qmake'

錯誤分析

初步懷疑中文路徑問題，但對比發現：

• 中文路徑錯誤會顯示 Cannot find file，表示 qmake 找不到 .pro 檔。
• 本錯誤為 Could not start process，指向 建置目錄 (Build Directory) 設定錯誤。

解決步驟

1. 開啟 Qt Creator → 專案 → 建置與執行 → 建置步驟。
2. 檢查 建置目錄 是否指向專案資料夾所在目錄（而非專案資料夾本身或其子目錄）。
3. 錯誤設定範例：
4. 正確設定範例：

建置目錄兩種可行模式

1. Shadow Build（隱式建置，預設推薦）

建置目錄與原始碼目錄分離，保持原始碼乾淨。

注意：qmake 不支援建置目錄在原始碼目錄「之下」的結構。

2. In-source Build（顯式建置）

建置目錄與專案目錄相同，檔案混雜但管理直觀。

根因總結與預防

• 移動專案資料夾後，Qt Creator 的建置/執行環境設定未自動更新，導致路徑失效。
• 遷移專案後，務必重新檢查 建置目錄、執行目錄、Kit 設定。
• 盡量避免中文路徑，若必要請統一編碼設定。