一、为什么需要打包成安装包？
在完成 QT 项目开发后，直接发布可执行文件（.exe）和依赖的 DLL 文件虽然可行，但存在以下问题：
- 用户体验差：用户需手动管理文件路径，容易因文件缺失导致程序崩溃。
- 权限管理难：无法自动创建开始菜单快捷方式、桌面图标或注册系统服务。
- 文件分散：动态库模式下大量 DLL 文件杂乱无章，静态库模式下可执行文件体积过大。
而使用 Inno Setup 打包成安装包可以完美解决这些问题：
- 自动创建安装向导，支持自定义安装路径、开始菜单条目等。
- 压缩文件体积，生成单一可执行安装程序（
.exe）。 - 支持卸载功能，自动清理残留文件。
二、Inno Setup 安装与配置
1. 下载与安装
- 官网地址：Inno Setup 下载页
- 版本选择：推荐下载 64 位 Installer（如
inno setup 6 Setup x64.exe），兼容现代 Windows 系统。 - 安装步骤：
- 双击安装包，选择默认语言（中文或英文）。
- 一路点击 下一步，默认安装路径为
C:\Program Files (x86)\Inno Setup 6。
2. 界面简介
安装完成后打开 Inno Setup Compiler，主界面包含：
- 脚本编辑器：编写安装逻辑的代码区域。
- 编译按钮：生成安装包的核心功能按钮（绿色三角图标）。
- 常用工具栏：快速访问向导、调试、语言设置等功能。
三、使用向导快速创建安装包
1. 启动脚本向导
点击菜单栏 文件 > 新建，或直接点击工具栏的 向导 图标，进入安装包创建向导。
2. 配置应用程序信息
（1）基础信息页
- 应用程序名称：例如
My QT App - 应用程序版本：
1.0.0 - 应用程序发布者：公司名或个人名称（如
TechCo Ltd） - 应用程序网站：可选填官网地址（如
https://www.techco.com）
（2）主执行文件页
- 点击添加：选择 QT 编译生成的
Release版可执行文件（.exe）。 - 自动添加依赖文件：若使用动态库模式，需手动添加
windeployqt导出的所有 DLL 和资源文件（建议先将.exe和依赖文件放在同一目录）。
（3）文件关联页（可选）
若程序需要关联特定文件类型（如 .qtx 文件），可在此处配置：
- 文件扩展名：输入
qtx - 描述：
QT App File - 图标：选择程序图标（
.ico）
（4）开始菜单文件夹页
- 菜单文件夹名称：建议与应用程序名称一致（如
My QT App） - 勾选创建桌面快捷方式：提升用户启动便利性。
（5）安装位置页
- 默认安装路径：建议使用
{programfiles}\My QT App（{programfiles}为系统变量，自动适配 32/64 位系统）。 - 允许用户更改路径：保持勾选，符合用户习惯。
（6）语言选择页
- 勾选中文（简体） 和 English，支持多语言安装界面。
（7）完成配置
- 脚本文件名：输入脚本保存路径（如
C:\MyApp\installer.iss）。 - 点击完成：向导自动生成初始安装脚本。
四、手动优化安装脚本（关键步骤）
向导生成的脚本可能需要进一步调整，以下是常见优化点：
1. 添加程序图标
在脚本开头添加：
; 定义程序图标路径（需替换为实际路径）
#define MyAppIcon "C:\\MyApp\\resources\\app.ico"
[Icons]
Name: "{group}\My QT App"; Filename: "{app}\MyApp.exe"; IconFile: "{app}\{MyAppIcon}"
Name: "桌面快捷方式"; Filename: "{app}\MyApp.exe"; IconFile: "{app}\{MyAppIcon}"; WorkingDir: "{app}"
2. 处理 QT 动态库依赖
若使用动态库模式，需确保所有 DLL 被正确包含。在 [Files] 节中：
; 示例：添加 QT 核心动态库
Source: "C:\MyApp\release\Qt6Core.dll"; DestDir: "{app}"; Flags: ignoreversion
Source: "C:\MyApp\release\Qt6Gui.dll"; DestDir: "{app}"; Flags: ignoreversion
Source: "C:\MyApp\release\Qt6Widgets.dll"; DestDir: "{app}"; Flags: ignoreversion
注意：
Flags: ignoreversion表示忽略版本检查，避免因版本不一致导致安装失败。- 若使用
windeployqt导出依赖，可直接复制整个目录到[Files]节，无需逐个添加文件。
3. 添加卸载功能
Inno Setup 自动生成卸载脚本，无需额外代码。安装完成后，会在开始菜单创建 卸载程序 快捷方式，用户可通过控制面板或快捷方式卸载程序。
4. 压缩文件以减小安装包体积
在 [Setup] 节中添加：
Compression=lzma2 ; 推荐压缩算法（体积最小，但压缩时间较长）
SolidCompression=yes ; 启用固态压缩，进一步减小体积
五、编译与测试安装包
1. 编译脚本
点击工具栏 编译 按钮（绿色三角），Inno Setup 会自动生成安装包（.exe），路径显示在底部日志窗口中。
2. 测试安装流程
- 双击安装包：检查安装向导是否正常显示，路径选择、快捷方式创建是否正确。
- 运行程序：安装完成后，通过桌面图标或开始菜单启动程序，验证功能是否正常。
- 卸载程序：通过开始菜单卸载快捷方式或控制面板，检查是否残留文件。
六、高级技巧：静态库模式打包
若使用 静态库编译 QT 程序（可执行文件不依赖 DLL），打包步骤更简单：
- 直接将静态编译的
.exe作为主文件添加到 Inno Setup。 - 无需包含任何 DLL 文件，安装包仅包含
.exe和资源文件，体积可能较大但部署更便捷。
静态库编译命令参考（QT 源码编译）：
configure -static -release -make libs -prefix "C:\Qt\static"
mingw32-make && mingw32-make install
七、常见问题与解决方案
1. 缺少 Qt6Core.dll 等依赖
- 原因：未正确使用
windeployqt导出动态库。 - 解决：
- 在 QT 命令行中运行
windeployqt your_app.exe重新导出依赖。 - 确保 Inno Setup 的
[Files]节包含所有导出的 DLL。
- 在 QT 命令行中运行
2. 安装包体积过大
- 原因：包含冗余文件（如调试版 DLL、示例资源）。
- 解决：
- 使用
windeployqt --release导出 Release 版 DLL。 - 启用 Inno Setup 的
lzma2压缩（见上文优化步骤）。
- 使用
3. 图标显示异常
- 原因：图标路径错误或格式不支持。
- 解决：
- 使用
.ico格式图标（推荐 256x256 像素）。 - 确保图标路径在脚本中正确引用（如使用绝对路径或
{app}变量）。
- 使用
八、总结
通过 Inno Setup 打包 QT 项目，既能提升用户体验，又能简化部署流程。动态库模式适合追求可执行文件体积小的场景，静态库模式适合需要完全独立部署的场景。建议根据项目需求选择合适的打包方式，并通过多次测试确保安装包的稳定性。
附：Inno Setup 脚本模板
; 脚本模板（动态库模式）
[Setup]
AppName=My QT App
AppVersion=1.0.0
AppPublisher=TechCo Ltd
AppPublisherURL=https://www.techco.com
AppSupportURL=https://www.techco.com/support
AppUpdatesURL=https://www.techco.com/updates
DefaultDirName={programfiles}\My QT App
DefaultGroupName=My QT App
OutputDir=C:\MyApp\installer
OutputBaseFilename=MyAppInstaller
Compression=lzma2
SolidCompression=yes
[Files]
Source: "C:\MyApp\release\*"; DestDir: "{app}"; Flags: recursesubdirs createallsubdirs
[Icons]
Name: "{group}\My QT App"; Filename: "{app}\MyApp.exe"
Name: "桌面快捷方式"; Filename: "{app}\MyApp.exe"; WorkingDir: "{app}"
[Run]
Filename: "{app}\MyApp.exe"; Description: "Launch My QT App"; Flags: nowait postinstall skipifsilent
通过以上步骤，即可轻松将 QT 项目打包为专业的安装程序，快去试试吧！ 🚀
