文章目录
-
-
- [一、 打包后缺少动态链接库（DLL/so）](#一、 打包后缺少动态链接库（DLL/so）)
- 二、打包后程序无法运行
- 三、打包后体积过大
- 四、图标和资源文件不显示
- 五、安装程序制作
- [六、 将程序打包成可执行文件](#六、 将程序打包成可执行文件)
-
- [1. 编译 Release 版本](#1. 编译 Release 版本)
- [2. 打包依赖库](#2. 打包依赖库)
-
- [Windows 平台](#Windows 平台)
- [Linux 平台](#Linux 平台)
- [macOS 平台](#macOS 平台)
- [3. 创建安装包（可选）](#3. 创建安装包（可选）)
- [4. 测试打包结果](#4. 测试打包结果)
-
Qt Creator 打包应用程序时经常会遇到各种问题，以下是一些常见问题及解决方法：
一、 打包后缺少动态链接库（DLL/so）
-
Windows 平台：
- 使用 Qt 自带的
windeployqt工具自动复制依赖库
bashwindeployqt --release your_app.exe- 注意：需要从 Qt 命令行工具中运行，确保环境变量正确
- 使用 Qt 自带的
-
Linux 平台：
- 使用
ldd命令查看依赖库：ldd your_app - 手动复制缺失的库或使用
linuxdeployqt工具
- 使用
-
macOS 平台：
- 使用
macdeployqt工具：macdeployqt your_app.app -dmg
- 使用
二、打包后程序无法运行
- 检查是否遗漏了 Qt 插件（如平台插件
qwindows.dll） - 确认应用程序与打包的库是同一架构（32位/64位）
- 在命令行中运行程序，查看错误输出以定位问题
三、打包后体积过大
- 只打包必要的模块，移除调试符号
- 使用 UPX 等工具压缩可执行文件
- 考虑静态链接（需要重新编译 Qt 源码）
四、图标和资源文件不显示
- 确保资源文件正确添加到 .pro 项目文件
- 打包时检查资源文件是否被正确包含
- 避免使用相对路径引用资源
五、安装程序制作
- Windows：可以使用 Inno Setup 或 NSIS 制作安装包
- Linux：可以创建 deb 或 rpm 包
- macOS：使用
macdeployqt生成 dmg 镜像
六、 将程序打包成可执行文件
在 Qt Creator 中将程序打包成可执行文件，需要根据不同操作系统进行相应操作，以下是详细步骤：
1. 编译 Release 版本
- 在 Qt Creator 左下角，将构建模式从
Debug切换为Release - 点击菜单栏
构建->重新构建项目，生成 Release 版本可执行文件 - 可执行文件通常位于项目目录下的
build-项目名-Desktop-Release文件夹中
2. 打包依赖库
Qt 程序运行需要依赖相应的动态链接库，需要将这些库与可执行文件一起打包：
Windows 平台
-
打开 Qt 命令行工具（
Qt x.x.x Command Prompt） -
切换到 Release 版本可执行文件所在目录：
bashcd 你的可执行文件路径 -
运行 Qt 自带的部署工具：
bashwindeployqt --release your_app.exe该工具会自动复制所有必要的 Qt 库、插件和资源文件
Linux 平台
-
使用
ldd命令查看依赖的库：bashldd your_app -
手动复制所需的库文件到应用程序目录，或使用第三方工具
linuxdeployqt：bashlinuxdeployqt your_app -appimage
macOS 平台
-
使用 Qt 自带的
macdeployqt工具：bashmacdeployqt your_app.app -dmg该命令会生成一个包含所有依赖的
.app应用和.dmg镜像文件
3. 创建安装包（可选）
如果需要制作更专业的安装程序：
- Windows：使用 Inno Setup 或 NSIS 制作安装脚本
- Linux ：创建
.deb（Debian/Ubuntu）或.rpm（Fedora/RHEL）包 - macOS ：
macdeployqt已支持直接生成.dmg镜像
4. 测试打包结果
- 将打包好的文件夹复制到没有安装 Qt 的相同系统环境中
- 运行可执行文件，检查是否能正常工作
- 如遇错误，可在命令行中运行程序查看具体错误信息