必须用Release模式编译并匹配Qt版本的命令行终端运行windeployqt，显式指定--qmldir、--translations等参数，人工核验platforms/、imageformats/等关键插件是否存在，路径须全英文无空格。
直接能跑的独立程序，必须先用 windeployqt 把所有依赖 DLL 和插件塞进同一个文件夹，否则双击就报“找不到 Qt5Core.dll”或“无法启动此程序”。它不是打包工具，只是依赖收集器——这一步漏了，后面怎么封装都白搭。
Release 编译后才能用 windeployqt
Debug 模式生成的是 Qt5Cored.dll 这类带 d 后缀的调试库，windeployqt 默认只认 Release 库。你用 Debug 编译的 yourapp.exe 去跑 windeployqt，它会安静地什么也不复制，或者复制错版本。
- 在 Qt Creator 左下角点电脑图标，把构建套件（Kit）设为 Release（不是 Debug）
- 点锤子重新构建，确认输出路径里是
yourapp.exe，不是yourappd.exe或带d后缀的 DLL - 别信“我刚编译过”，去文件管理器里打开 release 目录，亲眼看到
yourapp.exe文件存在
必须用匹配编译器的 Qt 命令行终端
windeployqt 不是通用命令，它和 Qt 安装路径、编译器 ABI、VC++ 运行时版本强绑定。你在 Qt Creator 里用 MSVC 2019 64-bit 构建，就得用“Qt 5.15.2 (MSVC 2019 64-bit)”这个终端来运行 windeployqt；用 MinGW 就得选带 MinGW 字样的终端。
- 不要用 Windows 自带的 cmd 或 PowerShell，它们 PATH 里的
windeployqt很可能来自另一个 Qt 版本 - 不要靠
where windeployqt查路径——它可能指向 Qt 6 的 bin，而你项目是 Qt 5.12 - 终端启动后，先执行
qmake -v和windeployqt --version，确认 Qt 版本和构建器一致
常见参数与必须加的选项
裸跑 windeployqt yourapp.exe 只能应付最简单的 Widgets 程序。一旦用了 QML、数据库、图片解码、翻译文件，就得手动补参数，否则运行时黑屏、不显示图片、中文变方块。
- 用了 QML：必须加
--qmldir，比如--qmldir ../src/qml，否则qrc:/main.qml找不到模块 - 需要中文翻译：加
--translations，且确保.qm文件已生成并放在对应目录 - 要支持 JPEG/PNG：默认会复制
imageformats/qjpeg.dll等，但如果windeployqt输出里没提Adding plugin imageformats，说明没识别到依赖，可强制加--no-opengl-sw（避免 ANGLE 冲突）再试 - 精简体积：加
--no-compiler-runtime（不复制 VC++ 运行库），但此时目标机器必须已装对应 vcredist
封装前必须人工核对文件结构
Enigma Virtual Box 或 NSIS 不会帮你发现缺失的 platforms/qwindows.dll，它只会把你当前文件夹里有的东西全打进去。如果 windeployqt 没复制成功，或者你手抖删了 iconengines/，打包完照样启动失败。
- 进入你的部署文件夹，检查是否存在：
yourapp.exe、platforms/qwindows.dll、imageformats/qjpeg.dll、styles/qwindowsvista.dll（如果用了样式） - 用
depends.exe（Dependency Walker）打开yourapp.exe，看是否有红色标记的缺失 DLL（尤其注意Qt5Gui.dll是否能正常解析qwindows.dll） - 图标要提前嵌入：如果用
.rc设置图标，确保yourapp.exe右键属性 → 详细信息页里“产品图标”已显示；否则 Enigma 打包后仍是空白图标
最容易被忽略的是路径字符——全英文、无空格、无中文，哪怕只是文件夹名含“测试”，windeployqt 都可能跳过某些插件复制。实操中建议从 C:\deploy\myapp 开始，稳了再挪地方。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
