windeployqt 报错常见原因是在错误路径运行或未作用于已编译的 .exe；需在 Release 输出目录执行，并根据编译器补全 VC++ 运行时或 MinGW 动态库，Qt Quick 项目必须用 --qmldir 指定 QML 根目录，插件精简可用 --dry-run 配合 --no-module。
windeployqt 找不到可执行文件或报错“no deployment configuration file found”
常见原因是没在构建目录下运行 windeployqt，或者传入了错误路径。它必须作用于已编译好的 .exe 文件，而不是源码或项目文件（如 .pro 或 .qmake.stash）。
正确做法是：先用 Qt Creator 或命令行完成 Release 构建，确保生成了 yourapp.exe（通常在 build-yourapp-Desktop_Qt_6_x_x_MinGW_64_bit-Release\release\ 这类路径下），然后 cd 进该目录再执行：
windeployqt --no-translations --no-opengl-sw yourapp.exe
-
--no-translations避免复制大量qt_xx.qm文件（除非你真需要多语言） -
--no-opengl-sw禁用软件 OpenGL 渲染器，减少冗余 DLL（如libEGL.dll、libGLESv2.dll） - 如果程序用了 Qt Quick，必须加
--qmldir指向qml源目录，否则QtQuick插件和 QML 类型无法加载
打包后运行闪退，事件查看器显示“缺少 VCRUNTIME140.dll”或“API-MS-WIN-CRT-*.DLL not found”
这是典型的 Visual C++ 运行时缺失，windeployqt 不负责部署 MSVC CRT，只管 Qt 自身依赖。它只对 MinGW 构建的程序自动复制 libgcc_s_seh-1.dll 和 libstdc++-6.dll，对 MSVC 构建完全不管。
解决方式取决于你的编译器：
- 用 MSVC 编译（如
Desktop_Qt_6_x_x_MSVC2019_64bit）→ 必须手动安装 Microsoft Visual C++ Redistributable（对应版本，如 2015–2022），或把vcruntime140.dll、msvcp140.dll等从Visual Studio\2019\VC\Redist\MSVC\下复制到程序目录\x64\Microsoft.VC142.CRT\ - 用 MinGW 编译 → 确保
windeployqt输出里包含libgcc_s_seh-1.dll和libstdc++-6.dll；若缺失，尝试加--compiler-runtime参数强制复制
Qt Quick 应用启动黑屏或报错“QML module not found”
windeployqt 默认不扫描 QML 文件，也不会自动识别 import 的模块路径，所以即使你工程里写了 import QtQuick.Controls 2.15，它也可能漏掉 QtQuick.Controls 插件和对应 QML 类型。
必须显式告诉它 QML 根目录：
windeployqt --qmldir ../src/qml yourapp.exe
-
--qmldir后面是.qmlproject或main.qml所在的父目录，不是单个 QML 文件 - 如果用了自定义 QML 模块（比如
import MyModule 1.0），需确保该模块的qmldir文件存在且格式正确，并将模块目录也加入--qmldir（可多次使用） - 打包后检查输出目录是否有
qml\QtQuick\Controls.2\qtquickcontrols2plugin.dll和qml\QtQuick\Templates.2\等子目录，缺一不可
为什么 windeployqt 复制了太多插件（如 sql、sensors、webview）？
默认行为是扫描 .exe 的导入表 + Qt 元对象系统信息，推测可能用到的模块，导致把未实际使用的插件也拉进来（比如 sqldrivers\qsqlite.dll 即使你没调用 QSqlDatabase）。
精简策略分两步：
- 先用
--dry-run查看它打算复制哪些文件：windeployqt --dry-run yourapp.exe，观察输出中哪些插件被列为 “will be deployed” - 再针对性排除：用
--no-，例如--no-sql、--no-sensors、--no-webengine；注意--no-webengine不影响QWebEngineView的基础支持，但会跳过整个webenginewidgets插件树 - 删掉不需要的插件后务必实测功能——有些模块被间接依赖（比如
QtMultimedia可能隐式依赖platforms\qwindows.dll，这个不能删）
实际部署前，别忘了用 Dependency Walker（或更现代的 Dependencies.exe）打开你的 .exe，确认所有 DLL 路径都已解析为相对路径，且没有红色未解析项。windeployqt 不会修复硬编码的绝对路径加载逻辑，这类问题得回代码里改。
