Qt Quick 桌面應用發布部署：依賴收集陷阱與 windeployqt 進階用法

Qt Quick（QML）應用部署比 Widgets 更複雜：windeployqt 僅能自動收集直接導入的 QML 模塊，無法感知運行時動態加載或C++ 端間接依賴（如 LocalStorage → Qt5Sql）。本文揭示部署「界面空白、模塊缺失」的根因，給出 main.cpp 顯式引入、.pro 聲明依賴的標準解法，並展示 Windows XP 兼容性實戰。

核心問題：windeployqt 的盲區

// main.qml
import QtQuick.LocalStorage 2.0  // 靜態導入，windeployqt 可檢測
// 但 LocalStorage 內部依賴 Qt5Sql.dll，windeployqt 不會自動帶上！

現象：部署包含 Qt5Quick.dll、qml/QtQuick/LocalStorage，但缺 Qt5Sql.dll → 運行時靜默失敗，界面空白或報錯「module not installed」。

標準解法：顯式聲明 C++ 依賴

1. main.cpp 添加頭文件引用（觸發鏈接依賴）

#include   // 強制鏈接 Qt5Sql.dll
#include 
// ... 其他必要模塊
int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);
    // ...
}

2. .pro 文件聲明 QT 模塊（核心）

QT += quick sql  // sql 模塊帶入 Qt5Sql.dll
// 如用網絡、XML、WebEngine 等同理添加
QT += network xml webengine

3. 重新構建並運行 windeployqt

windeployqt --qmldir ../src/qml MyApp.exe
# --qmldir 指定 QML 源碼目錄，幫助工具掃描 import 語句

Windows XP 兼容性實戰

Qt 5.5+ 官方不再支持 XP，但通過以下手段可在 XP SP3 上運行：

1. 使用 VS 2013 (v120_xp) 工具集 編譯 Qt 源碼或項目。
2. 避免 C++11/14/17 特性（或用 Polyfill）。
3. 部署時確保 msvcrt.dll 版本兼容（XP 缺 vsprintf_s 等安全函數）。
4. 實測：Qt 5.5 planets 例程在 2006 年 XP 機器上正常運行（見截圖）。

部署檢查清單

總結

Qt Quick 部署「三板斧」：

1. .pro 声明 QT += 模塊（解決 C++ 間接依賴）。
2. main.cpp #include 對應模塊（強化鏈接依賴）。
3. windeployqt --qmldir 源碼目錄（精準掃描 QML import）。

Windows XP 等舊系統需專用工具鏈編譯，並注意運行時庫兼容。掌握依賴傳遞鏈（QML import → C++ 模塊 → DLL），才能構建真正「開箱即用」的發布包。

1. 上一篇文章： C語言進程間通信：偽管道 popen/pclose 實現命令輸出捕獲
2. 下一篇文章： C語言進程間通信：signal 信號處理與 kill 發送，父子進程同步實戰

關於C

C 語言格式化輸入輸出大全：printf/sprintf/scanf/sscanf 進階用法與最佳實踐

函數族對比 函數輸出目標輸入源返回值 printf標

C語言深度解析：為什麼函數參數從右往左入棧？

呼叫慣例與棧框架：C語言參數傳遞的歷史與邏輯 C語言函數參數

C語言動態內存管理：malloc、calloc、realloc 詳解與實戰

三大函數聲明 #include void *malloc

C語言基礎練習：計算長整數各位數字之和

輸入一個大於等於 10 的整數，輸出其每一位數字的總和。例如