Release编译的.exe不能直接发给用户，必须配套DLL、插件目录和运行库三类依赖；需切对构建模式、在Qt环境命令行中用windeployqt（加--qmldir等参数）部署，并在干净虚拟机中验证。
直接发 Release 编译出的 .exe 给用户，90% 会闪退或报错——不是程序有问题，而是缺运行时依赖。Qt 程序在 Windows 上根本不能“单文件运行”，必须带齐 DLL、插件目录、运行库这三类东西，缺一不可。
Release 构建必须做对，否则后面全白忙
Qt Creator 左下角构建模式没切到 Release，就去打包，大概率复制的是带 d 后缀的调试库（比如 Qt6Cored.dll），目标机器上根本不存在。这类文件体积大、依赖多，且和正式环境不兼容。
- 确认当前构建套件对应的是你最终要发布的编译器（
MSVC 2019或MinGW 11.2等），别混用 - 构建完成后，手动进入输出目录（通常是
build-xxx-Desktop_Qt_6_5_0_MSVC2019_64bit-Release\release\），只取里面的yourapp.exe，别从debug目录误拿 - 本地双击刚生成的
yourapp.exe测试一次，确保 release 版本本身功能正常——有些逻辑（如未初始化指针、优化导致的变量生命周期变化）只在 release 下暴露
windeployqt 必须在 Qt 环境命令行里跑，cmd/powershell 直接失效
windeployqt 不是普通命令行工具，它严重依赖 QT_INSTALL_PREFIX 和 PATH 中的 Qt bin 路径。你在 Windows 自带 CMD 里直接敲 windeployqt.exe yourapp.exe，大概率报“找不到 Qt6Core.dll”或“无法解析插件路径”，因为它压根不知道自己该找哪个 Qt 版本。
- 从开始菜单搜索并打开对应环境的命令行，例如：
Qt 6.5.0 (MSVC 2019 64-bit)或Qt 6.5.0 (MinGW 11.2 64-bit) - 或者手动执行对应
qtenv2.bat（路径如C:\Qt\6.5.0\msvc2019_64\bin\qtenv2.bat），再运行命令 - 切换到
yourapp.exe所在的干净空文件夹（全英文路径，如D:\dist\），再执行：windeployqt.exe yourapp.exe --release --compiler-runtime
- 如果用了 QML，必须加
--qmldir参数，否则QtQuick.Controls等模块的 DLL 和插件不会被识别：windeployqt.exe yourapp.exe --qmldir "C:\src\myapp\qml" --release --compiler-runtime
打包后必查的三个目录和一个文件
windeployqt 自动生成的结构看着像“全了”，但实际常漏关键项。它默认不处理第三方库、不校验插件版本对齐、也不管 qt.conf 路径绑定是否生效。
-
platforms\qwindows.dll必须存在且能加载——缺失或版本错配会导致启动失败，错误提示是 “This application failed to start” 或 “Could not find the platform plugin” -
imageformats\qjpeg.dll（或qsvg.dll）这类功能插件，windeployqt只有在代码中显式调用过相关 API 才会拷，QML 里Image { source: "xxx.jpg" }这种写法它不一定识别，得靠--qmldir补救 -
plugins\styles\qwindowsvistastyle.dll如果用了系统风格，这个文件缺失会导致界面样式回退或崩溃 - 检查根目录是否有
qt.conf文件；没有的话建议手动加一个，内容为：[Paths] Plugins = plugins
——否则某些场景下插件路径会 fallback 到系统 Qt 安装目录，造成行为不一致
VC++ 运行库和 MinGW 运行库必须手动补全
--compiler-runtime 参数只对 MSVC 有效，它会把 vcruntime140.dll、msvcp140.dll 等拷进来。但如果你用的是 MinGW 编译器，windeployqt 完全不管 libgcc_s_seh-1.dll、libstdc++-6.dll、libwinpthread-1.dll 这三个文件，它们必须自己从 MinGW 的 bin 目录里复制过来，否则启动直接报错 0xc000007b。
- MinGW 用户：去
C:\Qt\6.5.0\mingw_64\bin\（或你实际安装路径）下找到上述三个 DLL，手动复制到发布目录根目录 - MSVC 用户：确认
--compiler-runtime是否真的生效——有时因 Qt 版本或工具链差异，仍需手动检查目标目录是否存在vcruntime140.dll - 不要试图把整个 Qt
bin目录下的 DLL 全塞进去，版本冲突或 ABI 不匹配反而导致 GUI 线程死锁
真正可靠的发布，不是看 windeployqt 执行完有没有报错，而是把整个发布目录扔进一台全新安装的 Windows 虚拟机（关闭杀软、不装任何开发工具），双击 yourapp.exe 看它能不能从启动、渲染、交互到退出全程稳定——这才是唯一有效的验证方式。很多问题（比如中文路径、高DPI缩放、字体渲染）只在这种环境下才会暴露。
