直接双击Qt生成的.exe失败是因为缺少Qt核心库（如Qt5Core.dll）、平台插件（如qwindows.dll）等依赖DLL，而Qt Creator通过环境变量自动提供路径，windeployqt是官方推荐的自动化解决方案，需配合Release构建与正确Kit使用。
.exe 文件大概率会失败——不是程序写错了，而是它缺一堆 .dll，比如 Qt5Core.dll、Qt5Widgets.dll、qwindows.dll，甚至还有 platforms/ 和 styles/ 这类目录。Qt Creator 本身不打包依赖，只负责编译出裸 exe。
为什么 Qt Creator 里能运行，单独双击就报错？
Qt Creator 启动时自动注入了环境变量（比如 PATH 指向你 Qt 安装目录下的 bin/），所以它能找到所有 .dll；而系统资源管理器双击时完全不认这些路径。
常见错误现象包括：
• 黑窗口一闪而退
• 弹窗提示“找不到 mingwm10.dll”或“无法启动此程序，因为计算机中丢失 Qt5Gui.dll”
• 窗口空白、无响应、标题栏有字但界面不渲染
windeployqt 是唯一靠谱的依赖收集方式
别手动复制 .dll，也别往 system32 里塞——容易冲突、污染系统、不同 Qt 版本间不兼容。windeployqt 是 Qt 官方工具，能智能识别你项目实际用到的模块（Widgets / Quick / SQL / SVG 等），只拷贝真正需要的文件。
实操建议：
• 先确保你已用 Release 模式成功构建（Qt Creator 左下角选 Release，点锤子图标）
• 找到生成的 .exe，把它单独拖进一个**全英文、无空格**的新文件夹（比如 D:\myapp\）
• 打开对应 Qt 版本的命令行（如 Qt 6.5.3 MinGW 64-bit，不是普通 cmd）
• 执行：
cd /d D:\myapp<br>windeployqt myapp.exe
• 如果是 Qt Quick 项目，必须加
--qmldir 参数，否则 QML 文件加载失败：windeployqt myapp.exe --qmldir "C:\Qt.5.3\mingw_64\qml"
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
Release 构建配置不对，windeployqt 也救不了
即使用了 windeployqt，如果构建套件（Kit）选错，生成的 .exe 本身就不兼容目标机器：
• 用 MSVC2019 套件构建的，必须在装了 Microsoft Visual C++ Redistributable 的机器上运行
• 用 MinGW 构建的，不能混用 32/64 位：你的 windeployqt 必须来自同一体系（例如 mingw_64\bin\windeployqt.exe 对应 64 位 .exe）
• .pro 文件里若写了 CONFIG += debug_and_release，但没显式选 Release，实际输出的可能是 debug 版——它依赖 Qt5Cored.dll 这类带 d 后缀的库，windeployqt 默认不处理 debug 库
双击前最后检查三件事
执行完 windeployqt 后，别急着双击，先确认：
• 当前文件夹里有没有 platforms/qwindows.dll（没有就一定白屏）
• .exe 文件名不含中文或特殊符号（某些 Qt 版本对路径编码敏感）
• 项目用了自定义字体、图片、QRC 资源，这些文件是否已随 windeployqt 一并复制（默认会，但若用了 --no-opengl-sw 等开关可能跳过）
windeployqt 的路径解析逻辑和你选对的构建套件——这两处错一个，整个发布流程就卡在黑窗口里出不来。 
