Windows平台下无需QT Creator部署QT程序的方法及运行问题解决

一、用Qt官方工具windeployqt（最省心的方法） #

• 找到Qt安装路径里的windeployqt.exe：路径一般是Qt\{你的Qt版本}\msvc20xx\bin或Qt\{你的Qt版本}\mingwxx\bin，选你编译程序时用的编译器对应的文件夹
• 打开CMD，切换到你编译好的Release版.exe所在文件夹
• 执行命令：windeployqt your_app.exe，工具会自动扫描并复制所有必需的Qt动态库、插件（比如平台插件qwindows.dll、图像格式插件）到程序目录
• 要是程序用到了第三方库（比如OpenCV、SQL驱动），得手动把这些库的动态文件也拷过来

二、手动补全缺失依赖（排查问题用） #

• 要是windeployqt漏了文件，用Dependency Walker（depends.exe）打开你的.exe，看哪些DLL没找到
• 从Qt安装目录的对应编译器文件夹里找出这些缺失的DLL，复制到程序目录
• 注意几个关键插件的路径：平台插件必须放在platforms子文件夹（比如qwindows.dll），图像格式插件放imageformats子文件夹，SQL驱动放sqldrivers子文件夹

三、打包成安装包（方便分发） #

• 用Inno Setup或NSIS这类工具，把程序目录里所有文件打包成一个安装程序，用户双击就能完成安装，还能自动创建快捷方式
• 也可以用Qt自带的Qt Installer Framework做更专业的安装包，支持组件选择、后续更新等功能

避坑要点 #

• 必须打包Release版本的程序，Debug版本依赖的带d后缀的DLL（比如Qt5Cored.dll）只能在有Qt开发环境的电脑上跑
• 编译器版本要对应：用MSVC2019编译的程序，就用MSVC版的windeployqt，别用MinGW的
• 程序用到的Qt模块（比如Qt Widgets、Qt Network），要确保对应的DLL都被正确复制

内容的提问来源于stack exchange，提问作者Tylerwang1989