使用 windeployqt 工具自动部署Qt依赖环境（DLL、插件、翻译文件等）

一，问题描述

新创建的qt quick程序，能够编译成功。且使用qt creator能够成功运行编译的程序。

但是，通过双击编译好的exe却无法运行程序，明显是缺少qt运行的依赖环境。

二，解决方法

1，找到并打开 Qt 命令行

在Windows开始菜单中，搜索"Qt"，找到与你的构建环境对应的命令行快捷方式，例如：

Qt 6.9.3 (MSVC 2019 64-bit) - 如果你使用的是64位MSVC编译器

Qt 6.9.3 (MinGW 64-bit) - 如果你使用的是MinGW编译器

2,在打开的命令行窗口中，使用 cd 命令切换到你的exe文件所在目录。

3,运行 windeployqt 命令

①Qt Widgets项目

windeployqt YourAppName.exe

②Qt Quick项目

windeployqt --qmldir F:\YourProject\qml YourAppName.exe
F:\YourProject\qml是QML文件所在源码目录
YourAppName.exe 是你编译出的exe名称

例如：

windeployqt --qmldir D:\HMM_SoftWare\HealthRiskAI appHealthRiskAI.exe

4，验证部署结果

回车执行成果后，会进行qt依赖环境的部署。

三、命令说明

总结上面的方法，可知命令格式为：

windeployqt --qmldir <项目源码路径> <exe文件名>

① windeployqt 是Qt官方提供的部署工具，能够自动分析程序依赖关系

②--qmldir <QML源码目录>
告诉工具QML源文件在哪里，工具会扫描这个目录中的所有QML文件，分析出你的项目使用了哪些QML模块（如QtQuick、QtQuick.Controls等）。它只部署实际用到的模块，减少不必要的文件。

③<exe文件名>

这是目标可执行文件，工具会分析这个exe文件链接了哪些Qt库。