Windows Qt Eclipse CDT 開發環境 19 大常見問題與解決方案彙總

環境搭建與建置系統問題

Q1: qmake 產生的 Makefile 損壞/遺失

解法：命令列進入專案目錄，執行 qmake -project 產生 .pro，再執行 qmake 重建 Makefile。注意手動補充 QT += core gui xml 等模組宣告。

Q2: Eclipse 設定 Qt Version 找不到 qmake

解法：新版 Qt SDK 路徑較深，qmake 通常在 Desktop/Qt/<version>/mingw/bin 下。

Q3: 編譯錯誤 Makefile:66: *** multiple target patterns. Stop.

解法：必須使用 Qt Eclipse 整合包附帶的 start.bat 啟動 Eclipse，該批次檔會正確設定 MinGW 路徑與環境變數。直接點 eclipse.exe 會缺少關鍵路徑。

Q4: Cannot run program "make": Launching failed

解法：在 mingw/bin 下複製 mingw32-make.exe 並重命名為 make.exe。

除錯與索引器問題

Q5: 無法啟動除錯，提示 You can't do that without a process to debug

解法：修改 start.bat，確保 PATH 包含 Qt bin、MinGW bin、Qt lib 目錄，並加入系統路徑。範例：

set PATH=D:/Qt/4.6.2_for_mingw/bin;D:/Qt/mingw/bin;D:/Qt/4.6.2_for_mingw/lib
set PATH=%PATH%;%SystemRoot%/System32
cd D:/Qt/eclipse-cpp-galileo-SR2-win32/eclipse
start eclipse.exe -clean

Q6: method setupUi could not be resolved (紅線報錯但能編譯)

解法：專案屬性 → C/C++ General → Indexer → 全勾選（特別是 "Index unused headers"、"Parse unused headers"），重建索引。

Q7: 如何使用 Release 建置

專案屬性 → C/C++ Make Project → Make Builder → Build (Incremental build) 屬性改為 release。

Q8: 除錯前自動中斷於 main 前 (No source available)

Debug Configurations → Debugger → 取消勾選 Stop on startup at main。

Q13: 程式卡在 ntdll (如 LdrAddRefDll) 進不入 main

Debug Configurations → Debugger Options → 取消勾選 Load shared library symbols automatically。

專案組織與資源管理

Q10: 如何用索引標頭檔管理深層目錄結構

建立 inc/ 目錄放置索引標頭檔，內部 #include "../src/xxx/yyy/zzz/A.h"。專案 .pro 加入 INCLUDEPATH += inc，Eclipse 專案屬性 → C/C++ Include Paths → Add External Include Path 加入 inc 目錄，即可啟用自動完成。

Q11: qrc 設定圖示路徑不顯示

qrc 採用 prefix + 相對路徑。建議將 prefix 設為 /，檔案實際相對路徑如 images/01042.png，最終資源路徑為 :/images/01042.png。

Q17: Release exe 在無 Qt 環境機器無法執行

將相依 DLL 打包同目錄：libgcc_s_dw2-1.dll、mingwm10.dll、QtCore4.dll、QtGui4.dll、QtXml4.dll 等（視實際引用模組增減）。

其他實用技巧

• Q12 STL 自動完成失效：專案/工作區加入 MinGW GCC 標頭路徑 (include、include/c++、include/c++/bits 等) 並 Rebuild Index
• Q14 Qt Assistant 位置：Desktop/Qt/4.7.4/mingw/bin/assistant.exe
• Q15 Assistant 內容為空：Edit → Preferences → Documentation → Add qt.qch
• Q16 斷點無法命中 (Breakpoint attribute problem)：暫無完美解，嘗試 Clean/Rebuild、重啟 Eclipse、檢查優化等級
• Q18 預定義巨集設定：專案屬性 → C/C++ General → Paths and Symbols → Symbols 分頁
• Q19 Qt Designer QWidget 無法建立 QToolBar：暫時將 .ui XML 的 class="QWidget" 改為 QMainWindow，加入 ToolBar 後再改回

環境安裝懶人包 (Q9)

無需單獨下載 MinGW、自行編譯 Qt。只需安裝：

1. Qt SDK (官方完整包)
2. Eclipse CDT
3. qt-eclipse-integration 插件

詳細步驟參考：CSDN 圖文教學