QT项目打包成可安装版本教程

前言最初写这篇博客是为了解决Qt程序在自己电脑上运行正常发给别人就闪退或报错的问题。核心原因在于脱离了本地环境后程序缺失了必要的依赖库和插件。因此我将这套从Release编译到打包成单文件exe的完整工作流记录下来希望能帮大家彻底解决跨电脑运行失败的问题。软件与开发环境说明操作系统Windows 10 (64-bit)Qt版本Qt 5.15.2编译器MinGW 7.3.0 64-bit依赖收集windeployqt.exe(Qt官方自带)单文件封装Enigma Virtual Box (免费工具)第三方库OpenCV、Boost等 (需额外准备Release版dll)提示无论Qt 5.x还是6.xMinGW还是MSVC核心打包逻辑相通。只需确保打包工具与编译套件的版本、位数严格一致即可。1、选择Rrelease模式构建项目Debug模式下打包的软件体积大且目标机器没有debug库会运行失败2、新建一个文件夹复制Rrelease生成的.exe可执行文件到新文件夹3、使用用QT官方命令环境推荐执行windeployqt可执行文件全名Qt 安装时会提供一个专用的命令行终端如 “Qt 5.15.2 (MinGW 8.1.0 64-bit)”它已自动配置好所有环境变量。可从开始菜单中找到并打开对应版本的 Qt 命令行工具再进入你的 exe 所在目录执行命令。文件夹中加入相关依赖此时双击应用程序运行可以正常运行如果提示报错按照提示加入项目相关依赖即可。如出现下图问题找到你项目用的该.dll复制到这个文件夹即可。4、也可以在路径搜索栏输入cmd打开命令行执行windeployqt可执行文件全名执行完成后文件夹目录加入QT相关依赖。本方法方便快捷但容易报错注意如果出现如下提示需手动添加项目使用版本的Qt 的bin目录添加到系统环境变量中重启命令窗口即可执行windeployqt命令双击运行.exe文件若报错找到项目对应依赖5、程序可以正常运行后可以生成压缩包发送给目标设备运行也可以使用Enigma Virtual Box打包成单exe发给目标设备运行Enigma Virtual Box官网地址enigma virtual box下载6、使用Enigma Virtual Box打包成单exe步骤如下打开Enigma Virtual Box免费工具软件选择你的yourApp.exe作为输入文件指定输出文件名点击Add Folder Recursively把windeployqt生成的整个目录全部添加进去在Files Options中勾选Compress files进行压缩点击Process生成独立单文件exe