QT打包exe文件攻略（Windows平台）：解决「其他电脑无法运行」的问题
【重点：windeployqt 项目名.exe】
引言：为什么需要打包Qt程序？
作为Qt开发者，我们常遇到这样的困扰：
在本地用Qt Creator编译生成的exe文件，copy到同事/客户的电脑上却无法运行，提示【缺少xxx.dll】【无法启动此程序】或界面崩溃。其根本原因是Qt程序依赖大量运行库（如Qt5Core.dll、Qt5Widgets.dll）、插件（如图像格式支持、数据库驱动）和系统环境（如VC++运行时）。直接拷贝exe无法携带这些依赖，导致"水土不服"。
本文将从打包原理到实战步骤，手把手教你生成独立的exe文件包，彻底解决跨电脑运行的问题。
一、Qt打包的核心原理
Qt程序的运行依赖分为三类，打包时需全部覆盖：
Qt核心库：Qt5Core.dll、Qt5Widgets.dll等（位于Qt安装目录/bin）。
插件：如imageformats/qjpeg.dll（图像解码）、sqldrivers/qsqlite.dll（SQLite数据库）。
系统运行库：如VC++ Redistributable（msvcr120.dll等，Windows专属）。
二、Windows平台打包实战
2.1 工具准备
Qt Creator（用来打开你的源码工程）；
windeployqt（Qt官方打包工具，随Qt安装包自带，路径：Qt安装目录/bin/windeployqt.exe）；
7-Zip/WinRAR（压缩打包后的文件）。
2.2 步骤1：用Qt Creator生成Release版EXE
我们一般调式的时候用的debug版本，其包含了很多调试信息，生成的exe比较大。而Release版本去除了这些生成的一般是KB级别。
打开项目，确保代码无编译错误；
点击左下角的选择构建套件，选择Release
点击下面的运行按钮（快捷键CTRL+R），生成Release版EXE（生成的路径可到“项目->构建设置”里查看）。
新建一个文件夹用于打包所有文件，文件夹名改成exe（随便取）。将生成的exe文件复制到该文件夹内。
2.3 步骤2：用windeployqt自动收集依赖
windeployqt是Qt官方提供的打包工具，能自动识别程序依赖的Qt库和插件，并复制到指定目录。
操作步骤：
1. 打开CMD或PowerShell；
2. 切换到之前新建的exe文件夹目录（如cd D:\exe）；
使用cmd来执行打包会出现dll不完整的情况，建议选择对应的qt命令工具
执行命令：
windeployqt 项目路径\项目名.exe
比如 windeployqt D:\exe\project.exe
执行结果：
工具会自动在exe同级目录生成Qt5Core.dll、Qt5Widgets.dll等核心库，以及plugins文件夹（包含图像、数据库等插件）。
2.4 步骤3：手动补充缺失的依赖（看情况）
有时windeployqt可能遗漏部分依赖，需手动检查并补充。当然你可以先跳到2.5步骤先验证一遍。
（1）VC++运行库（Windows专属）
Qt程序依赖VC++ Redistributable，需根据Qt编译器版本选择：
MSVC编译器（如Qt 5.15 MSVC2019）：需安装VC++ 2019 Redistributable（x86或x64，与EXE架构一致）；
MinGW编译器：无需额外安装（依赖已包含在libgcc_s_seh-1.dll等文件中）。
解决方法：
方案1：将VC++ Redistributable安装包（vc_redist.x64.exe）随EXE一起分发，用户安装后即可运行；
方案2：使用Dependency Walker（下载地址）分析EXE依赖，找到缺失的msvcrxxx.dll，从本地C:\Windows\System32复制到打包目录（仅推荐测试用，正式分发建议用方案1）。
（2）自定义插件或资源文件
若程序使用了自定义插件（如myplugin.dll）或资源文件（如images/目录下的图片），需手动复制到打包目录：
插件：复制到plugins/子目录（与Qt官方插件同级）；
资源文件：复制到程序同级目录（或通过QCoreApplication::applicationDirPath()获取路径）。
（3）配置文件（如config.ini）
若程序依赖外部配置文件（如config.ini），需将其与EXE放在同一目录，或在代码中指定绝对路径（避免相对路径失效）。
2.5 步骤4：验证打包结果
将打包目录（含EXE、Qt库、插件、VC++运行库）拷贝到未安装Qt的电脑，双击EXE测试：
若正常运行：打包成功；
若报错：根据提示缺失的DLL，回到步骤3补充依赖。
2.6 步骤5：压缩分发（可选）
为方便传输，可将打包目录压缩为ZIP文件（推荐7-Zip，压缩率高）。若需要生成安装包，可使用其他软件工具来制作安装程序（后篇再详述）。
三、macOS/Linux平台打包要点（未验证）
macOS
用macdeployqt工具（Qt安装目录/bin/macdeployqt）自动收集依赖；
依赖包括Qt.framework（核心库）、插件和dylib动态库；
分发时需包含Info.plist（应用信息）和图标（.icns）。
Linux
用linuxdeployqt工具（需手动安装，或用apt install linuxdeployqt）；
依赖包括libQt5Core.so等共享库，以及plugins目录；
分发时需确保系统已安装libxcb等基础库（或随包安装）。
四、常见问题与解决方案
问题1：报错【缺少MSVCR120.dll】
原因：EXE依赖VC++ 2013运行库，目标电脑未安装；
解决：打包时添加VC++ 2013 Redistributable（vc_redist.x64.exe），或提示用户自行安装。
问题2：界面显示乱码或字体缺失
原因：未打包字体文件（如微软雅黑.ttf）或区域设置错误；
解决：将字体文件复制到打包目录，或在代码中设置字体路径：
QFontDatabase::addApplicationFont(":/fonts/msyh.ttf"); // 从资源文件加载
问题3：插件无法加载（如图像无法显示）
原因：插件未放入plugins/目录，或路径错误；
解决：确保插件（如qjpeg.dll）位于打包目录/plugins/imageformats/下。
五、总结：打包的最佳实践
始终用Release模式编译：Debug模式包含调试符号，体积大且无意义；
优先用官方工具：windeployqt/macdeployqt/linuxdeployqt自动收集依赖，减少遗漏；
手动验证依赖：用Dependency Walker（Windows）或ldd（Linux）检查缺失的DLL；
分发时包含运行库：VC++运行库（Windows）、libxcb（Linux）等，避免用户额外安装；
测试跨环境：在未安装Qt的电脑上测试，确保可用。
通过以上步骤，你可以生成一个独立的Qt exe文件，彻底解决跨电脑运行的问题。打包虽繁琐，但却是Qt应用交付的必经之路——毕竟，用户不会为你的调试库买单！
秦灭周：周朝终结德菲尔轮胎是哪个厂生产？