Inno Setup 实战指南：从零构建专业 Windows 安装程序

1. 从“打包”到“交付”：为什么我们需要专业的安装程序

如果你开发过Windows桌面软件，一定经历过这个阶段：写好了代码，编译出一个.exe文件，兴冲冲地发给朋友或用户，结果对方反馈“打不开”、“提示缺少DLL”、“运行报错”。你这才意识到，你的程序不是孤岛，它依赖运行库、配置文件、注册表项，甚至需要管理员权限。把一堆零散的文件直接丢给用户，就像把汽车零件打包寄给买家，然后指望他自己组装上路——这显然不现实。

这就是安装程序存在的意义。它远不止是一个“文件复制器”，而是一个完整的软件交付解决方案。一个专业的安装程序，核心任务包括：环境检测（检查系统版本、.NET Framework或VC++运行库是否已安装）、文件部署（将程序文件、资源、文档复制到正确的目录，如Program Files）、系统集成（创建开始菜单项、桌面快捷方式、注册文件关联、写入必要的注册表项）、权限处理（在需要时请求管理员权限）以及用户配置（让用户选择安装路径、组件等）。最后，它还要提供卸载功能，让软件能够被干净、彻底地从系统中移除，不留垃圾。

在Windows平台，制作安装程序的工具有很多，从商业级的InstallShield、Advanced Installer，到开源免费的NSIS（Nullsoft Scriptable Install System）。而Inno Setup，则是其中在易用性、功能强大和免费开源之间取得了绝佳平衡的一个选择。它用简洁的脚本语言驱动，却能生成外观现代、逻辑严谨的安装包。对于独立开发者、小团队或需要频繁迭代的内部工具来说，Inno Setup几乎是标配。它解决了从“开发完成”到“用户可用”这最后一公里的所有琐碎但关键的问题。

2. Inno Setup 核心优势与典型应用场景拆解

为什么是Inno Setup？面对众多选择，它的独特价值体现在以下几个方面。

2.1 脚本驱动带来的极致灵活性与可维护性

与许多依赖GUI点选配置的安装工具不同，Inno Setup的核心是一个扩展名为.iss的脚本文件。这听起来有点技术门槛，但正是其强大之处。所有安装逻辑——文件列表、注册表操作、自定义页面、条件判断——都清晰地写在这个文本文件里。你可以用任何文本编辑器（推荐配合官方IDE）进行修改，并且可以轻松地使用版本控制系统（如Git）进行管理。每次发布新版本，你只需要基于旧脚本修改版本号、更新文件列表，整个过程可追溯、可重复，非常适合敏捷开发流程。

2.2 功能全面，覆盖安装全生命周期

Inno Setup的功能清单长得惊人：

• 基础操作：文件复制、目录创建、快捷方式设置、注册表读写。
• 运行库依赖：内置支持静默安装.NET Framework、VC++ Redistributable、DirectX等常见依赖。这是解决用户“缺少dll”报错的关键。
• 自定义界面：虽然默认界面已经足够清爽专业，但你完全可以自定义向导页面、修改图片、字体、颜色，甚至用[Code]段写Pascal脚本创建完全自定义的窗体，实现诸如许可证协议动态生成、序列号验证等复杂逻辑。
• 安装前后钩子：通过[Run]和[UninstallRun]段，你可以在安装前后、卸载前后执行任何程序或脚本，用于启动服务、更新数据库、删除用户数据等。
• 多语言支持：官方提供了数十种语言的翻译文件，制作国际化安装包非常简单。
• 压缩与分割：支持高效的压缩算法（如LZMA2），显著减小安装包体积。还能自动将大安装包分割成指定大小的分卷，方便光盘或网络分发。

2.3 轻量、免费且开源

Inno Setup本身是一个单文件编译器（ISCC.exe），生成的安装包无需额外解压运行时，体积小巧。它完全免费用于商业和非商业用途，并且其源代码在GitHub上公开。这意味着你永远不用担心许可费用，遇到极端问题甚至可以调试其源码（虽然绝大多数情况用不到）。

典型应用场景：

• 独立软件开发商（ISV）：为付费或免费的桌面软件制作标准的安装/卸载程序。
• 企业内部工具分发：将开发的数据处理工具、报表生成器等打包，方便IT部门统一部署到员工电脑。
• 游戏Mod或插件打包：将一堆散乱的文件和脚本，打包成一个可一键安装的集合。
• 驱动或系统组件安装：虽然专业驱动安装常用INF文件，但对于需要附带配置工具或用户协议的驱动包，Inno Setup也是一个好选择。

3. 手把手构建你的第一个安装包：从脚本解析到编译输出

让我们从一个最基础的安装包开始，理解Inno Setup脚本的核心结构。假设我们有一个简单的应用叫“MyApp”，它只有一个主程序MyApp.exe、一个配置文件config.ini和一个帮助文档help.pdf。

3.1 环境准备与项目创建

首先，从官网下载并安装Inno Setup。安装完成后，启动“Inno Setup Compiler”，它会引导你创建一个新的脚本文件（.iss）。我们选择“创建一个新的空白脚本文件”。

一个最基本的脚本框架如下：

; 脚本由 Inno Setup 脚本向导生成！ ; 有关创建 Inno Setup 脚本文件的详细资料请查阅帮助文档！ #define MyAppName "MyApp" #define MyAppVersion "1.0" #define MyAppPublisher "My Company, Inc." #define MyAppURL "https://www.example.com/" #define MyAppExeName "MyApp.exe" [Setup] ; 注意: AppId的值为单独标识该应用程序。 ; 不要为其他安装程序使用相同的AppId值。 ; (生成新的GUID，点击工具->生成GUID。) AppId={{你的GUID} AppName={#MyAppName} AppVersion={#MyAppVersion} AppPublisher={#MyAppPublisher} AppPublisherURL={#MyAppURL} AppSupportURL={#MyAppURL} AppUpdatesURL={#MyAppURL} DefaultDirName={autopf}\{#MyAppName} DefaultGroupName={#MyAppName} AllowNoIcons=yes ; 移除下一行注释以在安装程序没有非托管卸载字符串时，禁止在安装文件夹中生成卸载程序。 ;Uninstallable=no ; 输出基础文件名 OutputBaseFilename=mysetup ; 安装程序图标 SetupIconFile=myicon.ico ; 压缩方式 Compression=lzma2/ultra64 SolidCompression=yes WizardStyle=modern [Languages] Name: "english"; MessagesFile: "compiler:Default.isl" Name: "chinesesimplified"; MessagesFile: "compiler:Languages\ChineseSimplified.isl" [Tasks] Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked [Files] Source: "D:\Dev\MyApp\MyApp.exe"; DestDir: "{app}"; Flags: ignoreversion Source: "D:\Dev\MyApp\config.ini"; DestDir: "{app}"; Flags: ignoreversion Source: "D:\Dev\MyApp\help.pdf"; DestDir: "{app}"; Flags: ignoreversion ; 注意: 不要在任何共享系统文件上使用“Flags: ignoreversion” [Icons] Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}" Name: "{group}\{cm:UninstallProgram,{#MyAppName}}"; Filename: "{uninstallexe}" Name: "{autodesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; Tasks: desktopicon [Run] Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#StringChange(MyAppName, '&', '&&')}}"; Flags: nowait postinstall skipifsilent

3.2 核心脚本段详解

• [Setup]：全局设置段。这里定义了安装包的基本信息。

  • AppId：至关重要。它是系统识别你软件的唯一标识。卸载信息、控制面板中的“程序和功能”都依赖它。每次软件的重大升级（如1.0到2.0），如果希望新旧版本可并行安装，应更改AppId；如果希望升级覆盖，则保持AppId不变。务必使用GUID生成器生成一个唯一的。
  • DefaultDirName：默认安装目录。{autopf}是一个常量，在64位系统上会指向C:\Program Files或C:\Program Files (x86)（取决于安装程序架构），非常智能。
  • WizardStyle=modern：使用Inno Setup 6+的现代风格界面，视觉效果更好。

• [Languages]：定义安装程序支持的语言。这里添加了英文和简体中文。对应的.isl文件是语言文件，包含了所有界面文字的翻译。

• [Tasks]：定义用户可选任务。例如“创建桌面图标”，用户可以在安装时勾选或取消。

• [Files]：核心段，定义所有需要安装的文件。

  • Source：源文件在你开发机器上的路径。
  • DestDir：目标目录。{app}代表用户选择的安装目录。
  • Flags: ignoreversion：如果目标位置已存在同名文件，则仅当版本旧于源文件时才覆盖。对于你自己的程序文件，通常加上此标志。但对于系统共享文件（如DLL），绝对不要加这个标志，以免用旧版本覆盖系统的新版本，引发“DLL地狱”。

• [Icons]：定义创建的快捷方式。

  • {group}：代表“开始菜单”中的程序组。
  • {autodesktop}：代表桌面目录。

• [Run]：安装结束后运行的程序。这里设置为安装完成后自动启动主程序（Flags: nowait postinstall skipifsilent表示静默安装时不运行）。

3.3 编译与测试

脚本写好后，在Inno Setup Compiler中点击“编译”按钮（或按F9）。如果没有语法错误，它会在脚本同目录下生成一个Output文件夹，里面就是你的mysetup.exe安装程序。

注意：在测试安装包时，务必在虚拟机或非主力电脑上进行，或者至少为当前系统创建一个还原点。反复安装/卸载测试是常态，避免污染你的开发环境。

双击运行生成的安装程序，跟随向导一步步操作，观察文件是否被复制到正确位置，快捷方式是否创建，卸载程序是否正常工作。这是验证脚本逻辑的最直接方法。

4. 进阶实战：处理依赖、自定义页面与静默安装

一个基础的安装包只能算入门。现实中，我们面临的挑战要复杂得多。

4.1 自动安装运行库依赖

这是提升用户体验的关键一步。以安装VC++ 2015-2022 Redistributable为例，你不需要用户自己去微软官网下载。Inno Setup可以帮你静默安装。

首先，将对应的vc_redist.x64.exe（或x86版）下载并放置在你的脚本资源目录（比如一个Redist文件夹）。然后在[Files]段将其包含进去，并在[Run]段执行它。

[Files] ; 将运行库安装包打包进安装程序 Source: "Redist\vc_redist.x64.exe"; DestDir: "{tmp}"; Flags: deleteafterinstall [Run] ; 静默安装运行库，/install /quiet /norestart 是VC++运行库的标准静默安装参数 Filename: "{tmp}\vc_redist.x64.exe"; Parameters: "/install /quiet /norestart"; \ StatusMsg: "正在安装 Microsoft Visual C++ 运行库..."; \ Flags: waituntilterminated skipifdoesntexist

{tmp}是安装程序运行时的一个临时目录，安装结束后会自动清理。Flags: waituntilterminated确保运行库安装完成后，才继续我们的安装流程。skipifdoesntexist是安全措施，防止文件缺失导致安装失败。

4.2 创建自定义配置页面

假设你的软件需要用户输入一个服务器地址。Inno Setup允许你创建自定义向导页面来收集这些信息。

这需要在[Code]段编写Pascal脚本。以下是一个简单示例：

[Code] var ServerPage: TInputQueryWizardPage; ServerEdit: TEdit; procedure InitializeWizard; begin // 在“选择安装目录”页面之后，创建一个新的输入查询页面 ServerPage := CreateInputQueryPage(wpSelectDir, '服务器配置', '请设置应用程序连接的服务端信息', '请输入服务器地址和端口：'); // 添加一个输入框 ServerPage.Add('服务器地址:', False); // 可以添加更多，如 ServerPage.Add('端口:', False); // 获取输入框的引用，方便后续读取值 ServerEdit := ServerPage.Edits[0]; end; function NextButtonClick(CurPageID: Integer): Boolean; begin Result := True; // 当用户离开自定义页面时进行验证 if CurPageID = ServerPage.ID then begin if ServerEdit.Text = '' then begin MsgBox('服务器地址不能为空！', mbError, MB_OK); Result := False; end; // 可以添加更复杂的验证，如IP格式、端口范围等 end; end; procedure CurStepChanged(CurStep: TSetupStep); var ServerAddress: String; ConfigFile: String; Lines: TArrayOfString; begin // 在安装过程进行到“安装”步骤时，将用户输入写入配置文件 if CurStep = ssInstall then begin ServerAddress := ServerEdit.Text; ConfigFile := ExpandConstant('{app}\config.ini'); // 读取现有配置文件（假设是INI格式） if LoadStringsFromFile(ConfigFile, Lines) then begin // 遍历行，替换服务器地址配置项（这里简化处理，实际可能需要解析INI） // 更严谨的做法是使用 Inno Setup 的 `SetIniString` 函数 // 这里演示一个简单的文本替换思路 StringChangeEx(Lines[FindServerConfigLine], 'Server=', 'Server=' + ServerAddress, True); SaveStringsToFile(ConfigFile, Lines, False); end; end; end;

这段代码展示了创建页面、验证输入、在安装过程中将用户输入应用到配置文件的基本流程。[Code]段功能极其强大，几乎可以实现任何安装逻辑。

4.3 实现静默安装与卸载

静默安装对于批量部署或集成到其他安装流程中至关重要。Inno Setup生成的安装程序支持标准的静默安装参数。

• 静默安装：MySetup.exe /SILENT或MySetup.exe /VERYSILENT

  • /SILENT：显示进度条，但不显示向导界面。
  • /VERYSILENT：完全不显示任何界面，后台安装。
  • 还可以结合/DIR=”C:\MyPath”来指定安装目录，/NORESTART禁止重启等。

• 静默卸载：卸载程序通常位于安装目录下，名为unins000.exe（或类似）。静默卸载参数是/SILENT或/VERYSILENT。

  • 你也可以通过系统的msiexec命令来卸载，前提是安装时向系统注册了卸载信息（Inno Setup默认会做）。命令如：msiexec /x {产品代码} /quiet。但Inno Setup生成的是exe安装包，其产品代码（GUID）需要从注册表HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{你的AppId}中读取QuietUninstallString值来获得。

重要提示：在编写静默安装逻辑时，务必处理好所有需要用户交互的环节。例如，如果你的自定义页面是必需的，那么在静默模式下，要么通过脚本预设默认值，要么在[Code]中判断静默模式并跳过该页面。否则安装程序会挂起等待输入。

5. 避坑指南：从编译到部署的常见问题与解决方案

即使脚本语法正确，在实际打包和用户安装过程中，你依然会遇到各种“坑”。以下是一些高频问题及解决思路。

5.1 “文件正在使用”或“无法覆盖文件”错误

这在安装升级版本时尤其常见。原因是旧版本的程序（或相关服务）仍在运行，锁定了文件。

• 解决方案：
  1. 在[Setup]段使用RestartIfNeededByRun标志：这个标志会检测在安装过程中是否有由[Run]段启动的程序需要重启，并在安装结束后提示重启。但这属于事后补救。
  2. 更主动的方案：在安装前关闭旧进程。在[Code]段的InitializeSetup函数中，调用KillTask或ShellExec来结束指定进程。但这需要知道确切的进程名，且强制结束可能丢失用户数据。
  3. 最佳实践：设计应用程序支持单实例，并在收到关闭信号时优雅退出。可以在安装程序开始时，向已运行的主程序发送一个自定义的Windows消息，请求其关闭。这需要应用程序端配合。
  4. 对于服务，可以在[Run]段使用sc stop命令先停止服务，安装后再sc start启动。

5.2 生成的安装包在用户电脑上提示“Windows 已保护你的电脑”

这是Windows SmartScreen筛选器的警告。对于新发布的、没有足够声誉（下载量、数字签名时间）的应用程序，Windows会显示此警告。

• 解决方案：
  1. 获取代码签名证书并签名安装包。这是最根本、最专业的解决方案。你可以购买OV或EV代码签名证书，使用signtool.exe工具对生成的.exe安装包进行签名。EV证书可以立即建立信誉。
  2. 积累信誉。如果你的软件是免费的，可以通过微软的Windows Defender SmartScreen提交门户提交你的软件进行分析，逐步建立信誉。
  3. 用户教育。在下载页面明确说明此警告是正常的，并指导用户点击“更多信息”->“仍要运行”。但这很影响用户体验。

5.3 安装程序在Windows 7或某些特定系统上运行失败

可能的原因有很多：缺少系统补丁、权限问题、路径格式等。

• 排查思路：
  1. 检查[Setup]段的最低系统版本要求：MinVersion参数。确保没有设置过高。
  2. 检查依赖的运行库：你的安装程序或打包的应用程序可能需要更新的系统组件。例如，Inno Setup 6+的现代界面依赖Windows 10的控件，如果在Win7上想用，需设置WizardStyle=classic。
  3. 权限问题：如果安装目录是Program Files或系统目录，需要管理员权限。确保[Setup]段有PrivilegesRequired=admin（默认）。在Win7上，如果用户关闭了UAC，行为可能不同。
  4. 路径问题：避免在脚本中使用绝对路径（如C:\...），多使用{app},{pf},{commoncf}等预定义常量。路径中的空格或特殊字符也可能引发问题，用引号包裹路径字符串。

5.4 卸载不干净，残留文件或注册表项

这是衡量安装程序质量的关键。不干净的卸载会导致后续安装出现问题。

• 解决方案：
  1. 明确[Files]和[Dirs]段中每个条目的归属。Inno Setup会记录它安装的每一个文件和目录，并在卸载时删除。确保所有你创建的文件都列在了[Files]段。
  2. 谨慎使用Flags: uninsneveruninstall。这个标志会让文件在卸载时被保留。除非是用户数据文件（应放在{userappdata}下），否则不要轻易使用。
  3. 对于[Registry]段，Inno Setup同样会记录并删除它创建的键值。如果你修改了已存在的注册表项（而不是创建全新的），卸载时可能无法恢复原状，需要额外小心。
  4. 善用[UninstallDelete]段。可以指定卸载时需要额外删除的文件或目录（例如，运行时生成的临时日志文件）。
  5. 测试！测试！测试！在虚拟机中反复执行安装-卸载循环，并使用注册表监视工具（如RegShot）和文件系统监视工具，对比安装前后的快照，检查是否有“漏网之鱼”。

5.5 安装程序自身被识别为病毒或恶意软件

这通常是误报（False Positive）。一些启发式杀毒软件会对打包工具、加壳工具或行为敏感（如写入Program Files、添加注册表自启动项）的程序报毒。

• 应对策略：
  1. 提交误报。将你的安装包提交给各大杀毒软件厂商（如Virustotal上的各家厂商），说明这是用Inno Setup打包的合法软件，请求他们将其加入白名单。
  2. 避免敏感操作：除非必要，不要在安装时写入Run或RunOnce注册表键（这常被视作恶意行为）。如果需要开机启动，应征得用户同意或提供选项。
  3. 使用官方编译器：确保你使用的ISCC.exe是从官网下载的，避免使用被修改过的版本。
  4. 代码签名：同样，有效的代码签名证书能极大减少误报。

制作安装程序是软件交付的最后一步，也是用户接触产品的第一步。一个粗糙、出错甚至带有病毒的安装包，会直接毁掉用户对软件本身的信任。Inno Setup以其强大的灵活性，让你能精细控制这个“第一印象”的每一个细节。从简单的文件复制到复杂的依赖管理和自定义逻辑，它几乎能满足所有桌面软件的分发需求。花时间打磨你的安装脚本，进行充分的跨平台、跨环境测试，其回报将是用户平滑的安装体验和更少的售后支持请求。