基于MSVC编译器的Qt应用跨Windows系统部署方案问询

Hey there! 我来一步步帮你搞定用MSVC编译的Qt程序部署到不同Windows机器的事儿，其实流程和MinGW有相通的地方，但细节上得注意MSVC的特性，咱们慢慢捋：

首先得在Qt Creator里选对对应的MSVC Kit——比如你装的是VS 2022，就选Desktop Qt 6.x.x MSVC2022 64bit（32位同理）。然后切换到Release构建模式，点击编译按钮，等编译完成后，在项目输出目录里找到你的your_app.exe（一般在build-xxx-Release文件夹下的release子目录里）。

这一步和MinGW类似，但有个关键前提：必须打开对应的VS开发者命令提示符，不能直接用系统的cmd！比如你用的是64位MSVC 2022，就打开x64 Native Tools Command Prompt for VS 2022，这样环境变量才会正确配置，windeployqt才能找到MSVC版本的Qt库。

打开命令提示符后，cd到你的Release版exe所在的文件夹，然后运行命令：

windeployqt your_app.exe

这个命令会自动扫描你的程序用到的Qt模块，把对应的dll、平台插件（比如qwindows.dll，放在platforms文件夹里）、资源文件等都复制到exe所在目录。如果你的程序用到了QML、SQL驱动这类特殊模块，可以加额外参数，比如--qmldir ./your_qml_files来指定QML目录，确保相关依赖被复制。

这是MSVC和MinGW最大的区别之一，MinGW的运行时dll可以直接和Qt依赖一起打包，但MSVC的运行时需要单独处理，有两种方式可选：

方式一：静态链接VC++运行时 #

这种方式最省心，编译出来的exe不需要额外带运行时dll，但程序体积会稍大。设置方法：

• 在Qt Creator里打开项目的构建设置，切换到MSVC的Release配置
• 找到编译器选项，在“附加命令行参数”里添加/MT（表示静态链接多线程Release版本的VC++运行时）
• 重新编译程序，这样生成的exe就把VC++运行时整合进去了，部署时不用管运行时的问题

方式二：动态链接VC++运行时（默认方式） #

如果不想静态链接，就得把VC++运行时的依赖带上：

• 最简单的办法是让目标机器安装对应的Microsoft Visual C++ Redistributable安装包，比如你用的是MSVC 2022，就找对应版本（32/64位要和程序一致）的安装包，用户安装后就能运行你的程序
• 也可以手动把运行时dll复制到exe所在目录，比如vcruntime140.dll、msvcp140.dll、vcruntime140_1.dll这些，这些dll一般在VS的安装目录里，或者系统的System32/SysWOW64文件夹里（注意要复制对应版本的）

如果你的程序用到了Qt之外的第三方库（比如OpenCV、Boost之类的），windeployqt是不会自动处理这些的，你得自己把对应的MSVC版本的dll复制到exe所在目录。比如你用了64位MSVC编译的OpenCV，就把opencv_worldxxx.dll复制过去。

找一台没有安装Qt和VS的干净Windows机器，把整个exe所在的文件夹复制过去，双击exe看看能不能正常运行。如果报错缺少dll，就按下面排查：

• 是不是Qt的某个模块没被windeployqt识别？可以尝试手动指定模块，比如windeployqt --modules core gui widgets your_app.exe
• 是不是VC++运行时没处理好？如果是动态链接，检查dll有没有复制全，或者安装包版本是否匹配
• 是不是第三方库的dll漏了？对照你的项目依赖，把对应的dll补上

如果要给用户更友好的体验，可以用Inno Setup或者NSIS这类工具把整个程序文件夹和VC++ Redistributable打包成一个安装包。比如Inno Setup可以设置在安装过程中自动检测并安装VC++运行时，用户一键就能完成安装，不用手动操作一堆文件。

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