Qt Widgets 桌面應用發布部署：windeployqt 一鍵自動化

Qt 5+ 官方提供 windeployqt 工具，可自動分析可執行文件依賴，將所需 Qt 庫、插件、QML 模塊、編譯器運行時複製到部署目錄。本文演示 Qt Widgets 專案從創建到一鍵部署的完整流程，並在 Qt Creator 中集成部署步驟，實現「構建即發布」。

部署前準備

1. 安裝 Qt（含 MinGW/MSVC 編譯器）。
2. 構建發布版：Build → Build for Release。
3. 確認 windeployqt.exe 在 PATH 中（通常在 Qt/版本/編譯器/bin）。

命令行手動部署

cd build-Project-Desktop_Qt_5_15_2_MinGW_64_bit-Release/release
windeployqt Project.exe

工具會掃描 Project.exe 導入表，遞歸複製：

• Qt 核心庫：Qt5Core.dll, Qt5Widgets.dll, Qt5Gui.dll...
• 平台插件：platforms/qwindows.dll
• 圖片格式插件：imageformats/qjpeg.dll, qsvg.dll...
• 編譯器運行時：libgcc_s_seh-1.dll, libstdc++-6.dll, libwinpthread-1.dll (MinGW) 或 vcruntime140.dll (MSVC)。

Qt Creator 一鍵部署配置

在「項目」→「構建步驟」→「添加構建步驟」→「自定義處理步驟」：

構建發布版後，部署目錄自動生成完整依賴樹，可直接打包分發。

驗證部署包

1. 將 release 目錄複製到無 Qt 環境的乾淨 Windows 虛擬機。
2. 雙擊 Project.exe，界面正常顯示、功能正常運行。
3. 使用 Dependency Walker 或 listdlls 確認無缺失 DLL。

常見坑點與對策

總結

Qt Widgets 部署核心三步：

1. 構建 Release：優化體積、去除調試符號。
2. 運行 windeployqt：自動解決依賴地獄。
3. 驗證乾淨機：確保零依賴運行。

將 windeployqt 集成進 Qt Creator 構建流程，實現「一次配置，構建即發布」，極大提升交付效率。下一篇將講解 Qt Quick 應用部署的特殊坑點（QML 模塊依賴、編譯器運行時等）。