1. 项目概述：为什么Inno Setup依然是Windows安装包制作的“瑞士军刀”

如果你在Windows平台上开发过软件，尤其是那些需要分发给最终用户使用的桌面应用，那么你一定绕不开“打包”这个环节。无论是用Python写的脚本工具、Java开发的桌面客户端，还是C++编译的原生程序，最终都需要一个.exe安装包，让用户双击、下一步、完成安装。市面上工具很多，从商业化的InstallShield、Advanced Installer，到开源的NSIS、WiX，选择不少。但在我过去十多年的项目交付经验里，Inno Setup始终占据着一个独特而稳固的位置——它就像一把“瑞士军刀”，功能全面、稳定可靠、脚本驱动，最关键的是，它完全免费且开源。

这次我们不谈那些基础的单文件打包，那些用PyInstaller或electron-builder能一键搞定的事情。我们要深入的是那些让一个专业安装包真正“好用”的细节：如何让安装包在安装时自动关联文件类型并配上专属图标？如何静默地设置或修改系统环境变量，让软件在安装后就能从命令行直接调用？以及，如何将主程序、依赖库、运行时环境（比如JRE、Python解释器）甚至配置文件，优雅地打包成一个完整的安装包？这些需求，恰恰是Inno Setup的脚本（.iss文件）大显身手的地方。网络上很多教程只教你怎么把文件塞进安装包，但关于文件关联、环境变量、多组件打包这些进阶配置，往往语焉不详，或者给出的脚本片段存在兼容性问题。今天，我就结合自己踩过的坑和积累的经验，手把手带你拆解一个功能完备的.iss脚本，让你彻底掌握这些核心设置。

2. 脚本骨架搭建：理解Inno Setup脚本的基本结构

在深入细节之前，我们必须先统一“语言”。一个Inno Setup脚本（.iss文件）的结构非常清晰，它由几个核心的[Section]构成。你可以把它想象成一个乐高积木套装，每个[Section]是一类特定功能的积木块，我们按需拼接。下面是一个最简骨架，也是我们后续所有扩展的基础：

; 注释以分号开头。这是一个示例脚本骨架 #define MyAppName "我的应用程序" #define MyAppVersion "1.0" #define MyAppPublisher "我的公司" #define MyAppURL "https://www.example.com/" #define MyAppExeName "MyApp.exe" [Setup] ; 安装程序本身的全局设置 AppId={{你的唯一GUID，可用工具生成} AppName={#MyAppName} AppVersion={#MyAppVersion} AppPublisher={#MyAppPublisher} AppPublisherURL={#MyAppURL} AppSupportURL={#MyAppURL} AppUpdatesURL={#MyAppURL} DefaultDirName={autopf}\{#MyAppName} DefaultGroupName={#MyAppName} OutputDir=userdocs:Inno Setup Examples Output OutputBaseFilename=mysetup Compression=lzma2/ultra64 SolidCompression=yes ; 这里会添加我们后续讨论的所有关键设置 [Languages] Name: "english"; MessagesFile: "compiler:Default.isl" Name: "chinese"; MessagesFile: "compiler:Languages\ChineseSimplified.isl" [Tasks] ; 安装时的可选任务，例如创建桌面快捷方式 Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}" [Files] ; 这是核心，指定哪些文件要被打包进安装包 Source: "MyApp.exe"; DestDir: "{app}"; Flags: ignoreversion ; 后续我们会在这里添加更多文件，如DLL、配置文件等 [Icons] ; 创建开始菜单和桌面快捷方式 Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}" Name: "{commondesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; Tasks: desktopicon [Run] ; 安装完成后运行的程序，例如启动主程序 Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#StringChange(MyAppName, '&', '&&')}}"; Flags: nowait postinstall skipifsilent [UninstallDelete] ; 卸载时需要额外删除的文件或目录（非安装的文件） ; Type: files; Name: "{app}\someconfig.ini"

提示：{#MyAppName}这种是预处理器的宏引用，在[Setup]等节中，使用花括号{}引用定义好的常量或内置变量，能让脚本更易维护。{app}代表用户选择的安装目录，{group}代表开始菜单程序组。

这个骨架已经能生成一个可用的安装包了。但要让安装包“专业”起来，我们需要在[Setup],[Files],[Registry],[Tasks]等章节中添加更多“积木”。接下来，我们就围绕标题中的几个核心需求，逐一攻破。

3. 文件关联与图标设置：让系统“认识”你的专属格式

文件关联是提升用户体验的关键一步。想象一下，用户下载了一个你的图像处理软件，安装后双击.myimg格式的图片，系统却不知道用什么程序打开，这体验就大打折扣。Inno Setup通过[Registry]节和[Icons]节（是的，图标节也能用于文件类型）来完美解决这个问题。

3.1 注册文件关联的核心原理

在Windows中，文件关联本质上是向注册表写入一系列键值。主要涉及HKEY_CLASSES_ROOT（HKCR）下的几个关键位置：

1. 扩展名键：例如.myapp。它有一个默认值，指向一个“文件类型标识符”（ProgID），比如MyCompany.MyApp.1。
2. ProgID键：即上面提到的标识符（如MyCompany.MyApp.1）。这个键下定义了该文件类型的详细信息，包括默认图标、打开命令等。
3. 打开命令子键：在ProgID键下，通常有一个shell\open\command子键，其默认值就是用于打开此类文件的命令行，例如"{app}\MyApp.exe" "%1"。

Inno Setup的[Registry]节就是用来向这些位置写入数据的。一个完整的文件关联配置示例如下：

[Registry] ; 1. 注册扩展名 .myapp 到 ProgID Root: HKCR; Subkey: ".myapp"; ValueType: string; ValueName: ""; ValueData: "MyCompany.MyApp.1"; Flags: uninsdeletevalue ; 卸载时删除我们创建的这个值，但不会删除整个.myapp键（如果其他程序也用了） ; 2. 创建并定义 ProgID Root: HKCR; Subkey: "MyCompany.MyApp.1"; ValueType: string; ValueName: ""; ValueData: "我的应用程序文档"; Flags: uninsdeletekey ; 卸载时删除整个ProgID键，这是最干净的清理方式 Root: HKCR; Subkey: "MyCompany.MyApp.1\DefaultIcon"; ValueType: string; ValueName: ""; ValueData: "{app}\MyApp.exe,0"; Flags: uninsdeletekey ; 设置文件图标。",0"表示使用exe文件中的第一个图标资源。也可以指定一个单独的.ico文件路径。 Root: HKCR; Subkey: "MyCompany.MyApp.1\shell\open\command"; ValueType: string; ValueName: ""; ValueData: """{app}\MyApp.exe"" ""%1"""; Flags: uninsdeletekey ; 定义打开命令。注意路径和参数都用双引号包裹，以处理路径中的空格。

关键点解析与避坑经验：

• ProgID的命名：最好采用“公司名.应用名.版本号”的格式，如MyCompany.MyApp.1。这能最大程度避免与其他应用程序冲突。版本号（.1）允许你在未来更新关联行为时创建新的ProgID（如.2），而不会影响已安装的旧版本。
• 卸载清理策略（Flags）：这是最容易出问题的地方。对于扩展名键（.myapp），我们通常使用uninsdeletevalue，只删除我们写入的默认值，避免误删其他程序可能设置的关联。对于我们创建的ProgID键（MyCompany.MyApp.1及其子键），则使用uninsdeletekey，在卸载时彻底删除，不留垃圾。
• 图标路径：{app}\MyApp.exe,0是最常用的方式，直接从主程序的资源中提取图标。如果你有独立的图标文件，可以写成{app}\myicon.ico。,0中的数字是图标在exe或dll资源中的索引（从0开始）。
• 路径中的空格：在command的ValueData中，exe路径和参数%1都必须用双引号包裹。Inno Setup脚本中，双引号需要用两个双引号""来转义，所以看起来是"""..."""，略显复杂但必须如此。

3.2 为关联文件类型添加自定义图标（非exe内嵌）

有时，你可能希望为特定的文件类型使用一个与主程序不同的、更贴切的图标。这时，你需要将图标文件打包，并在注册表指向它。

[Files] ; 首先，将图标文件打包进安装包 Source: "docicon.ico"; DestDir: "{app}"; Flags: ignoreversion [Registry] Root: HKCR; Subkey: "MyCompany.MyApp.1\DefaultIcon"; ValueType: string; ValueName: ""; ValueData: "{app}\docicon.ico"; Flags: uninsdeletekey

这样，所有.myapp文件都会显示为docicon.ico这个图标。

3.3 在Windows资源管理器中刷新关联

修改注册表后，文件关联不会立即在所有地方生效，特别是已经打开的资源管理器窗口。为了提供更好的体验，我们可以在安装结束时调用系统API刷新。这需要一点Pascal脚本（Inno Setup支持内嵌的Pascal脚本）。在[Code]节中添加以下函数，并在[Run]节中调用：

[Code] procedure RefreshShell; var shell: Variant; begin try shell := CreateOleObject('Shell.Application'); shell.Windows.Item.Refresh; except // 忽略错误，刷新不是关键操作 end; end; [Run] ; ... 其他运行项 Filename: "{app}\{#MyAppExeName}"; Description: "启动程序"; Flags: nowait postinstall skipifsilent ; 在安装最后阶段调用刷新 Filename: "{sys}\rundll32.exe"; Parameters: "shell32.dll,Control_RunDLL appwiz.cpl,,0"; Flags: waituntilterminated runhidden; StatusMsg: "更新系统设置..." ; 上面这行是调用“程序和功能”控制面板的一种方式，也能触发刷新。更直接的是在[Code]的CurStepChanged事件中调用RefreshShell。

更优雅的做法是在安装过程的最后一步（ssPostInstall）自动调用刷新函数。这需要在[Code]节中实现CurStepChanged事件。

[Code] procedure CurStepChanged(CurStep: TSetupStep); begin if CurStep = ssPostInstall then begin RefreshShell; // 也可以广播系统消息，更彻底地刷新 RefreshEnvironment; end; end;

4. 环境变量的静默设置：让命令行“即装即用”

很多开发工具、运行时环境（如Java JDK、Python、Node.js）都需要配置系统或用户环境变量，特别是PATH，以便在任意命令行窗口直接运行。Inno Setup通过[Registry]节操作HKCU\Environment（用户变量）和HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment（系统变量）来实现。但这里有一个巨大的坑：直接修改注册表后，环境变量不会立即对当前进程（包括安装程序本身）和已打开的CMD窗口生效，需要重启或广播消息。

4.1 设置用户级PATH环境变量（推荐）

对于大多数应用程序，修改当前用户的PATH变量是更安全、不需要管理员权限（在非管理员安装时）的做法。

[Registry] ; 将应用目录添加到用户PATH环境变量 Root: HKCU; Subkey: "Environment"; ValueType: expandsz; ValueName: "PATH"; ValueData: "{olddata};{app}"; Check: NeedsAddPath('{app}') ; Check参数是关键，它调用一个函数检查路径是否已存在，避免重复添加。

这里用到了Check参数和一个自定义函数NeedsAddPath。{olddata}是一个特殊的常量，代表该注册表键现有的数据。expandsz是数据类型，表示可扩展的字符串（环境变量常用）。Check函数确保只在路径不存在时才执行写入操作。

4.2 实现NeedsAddPath检查函数

这个函数需要写在[Code]节中，它负责解析现有的PATH字符串，判断我们的目标路径是否已经存在。

[Code] function NeedsAddPath(Param: string): boolean; var OrigPath: string; AppPath: string; begin // 从注册表读取当前用户的PATH if not RegQueryStringValue(HKCU, 'Environment', 'PATH', OrigPath) then begin // 如果PATH不存在，那肯定需要添加 Result := True; exit; end; // 将目标路径标准化（去除尾部反斜杠，统一大小写？） AppPath := Param; // 简单的包含性检查。注意：这种方法不完美，可能误判（如子目录）。 // 更严谨的做法是分割字符串后逐个比较。 if Pos(';' + Uppercase(AppPath) + ';', ';' + Uppercase(OrigPath) + ';') > 0 then Result := False // 已存在 else Result := True; // 需要添加 end;

注意：这个NeedsAddPath函数是一个简化版。在实际生产环境中，你需要一个更健壮的版本：将PATH按分号分割成数组，对每个路径进行标准化（去除首尾空格和引号，统一大小写或使用系统API进行路径比较），然后再判断是否相等。否则，可能会因为路径格式的细微差别（如末尾有无反斜杠、大小写）导致重复添加或添加失败。

4.3 设置系统级环境变量（需要管理员权限）

如果你的软件需要为所有用户设置环境变量，或者要设置像JAVA_HOME这样的变量，就需要操作HKLM（本地机器）。这通常需要安装程序以管理员权限运行（在[Setup]节设置PrivilegesRequired=admin）。

[Setup] PrivilegesRequired=admin [Registry] ; 设置 JAVA_HOME 系统变量 Root: HKLM; Subkey: "SYSTEM\CurrentControlSet\Control\Session Manager\Environment"; ValueType: expandsz; ValueName: "JAVA_HOME"; ValueData: "{app}\jre"; Flags: preservestringtype ; 将JRE的bin目录添加到系统PATH Root: HKLM; Subkey: "SYSTEM\CurrentControlSet\Control\Session Manager\Environment"; ValueType: expandsz; ValueName: "PATH"; ValueData: "{olddata};{app}\jre\bin"; Check: NeedsAddPathSystem('{app}\jre\bin')

同样，你需要一个针对系统PATH的NeedsAddPathSystem检查函数，其逻辑与用户PATH类似，但查询的注册表根键是HKLM。

4.4 立即生效环境变量的“黑魔法”

如前所述，修改注册表后，环境变量不会立即生效。为了让新打开的CMD窗口能立即识别新PATH，我们需要广播WM_SETTINGCHANGE消息。这同样通过[Code]节实现。

[Code] procedure RefreshEnvironment; var EnvVarPath: string; Res: integer; begin // 广播环境变量已更改的消息 EnvVarPath := 'Environment'; SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 0, Longint(PChar(EnvVarPath)), SMTO_ABORTIFHUNG, 5000, Res); end; procedure CurStepChanged(CurStep: TSetupStep); begin if CurStep = ssPostInstall then begin RefreshEnvironment; // 同时也可以刷新Shell，一举两得 RefreshShell; end; end;

将RefreshEnvironment在安装最后一步调用，这样安装完成后，用户新打开的命令行窗口就能直接使用新配置的环境变量了。实测下来，这是最有效、对用户干扰最小的方法。有些教程会建议用户重启电脑，这对于普通软件来说体验太差，应尽量避免。

5. 多程序与依赖项打包：构建一体化部署方案

现代软件很少是单个exe文件。一个完整的应用可能包含：主程序、多个辅助工具（如命令行工具、配置编辑器）、依赖的DLL库、运行时环境（JRE, .NET Framework, VC++ Redistributable）、配置文件、帮助文档等。Inno Setup的[Files]和[Components]节让这种复杂打包变得井然有序。

5.1 使用[Files]节组织所有文件

[Files]节是打包的核心。你可以使用通配符、递归复制来包含大量文件。

[Files] ; 主程序 Source: "Release\MyApp.exe"; DestDir: "{app}"; Flags: ignoreversion ; 递归复制整个Libs目录下的所有DLL Source: "Libs\*.dll"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs ; 复制运行时环境，例如一个便携版JRE Source: "jre\*"; DestDir: "{app}\jre"; Flags: ignoreversion recursesubdirs createallsubdirs ; 复制配置文件模板 Source: "config\default.ini"; DestDir: "{app}"; Flags: onlyifdoesntexist ; 复制文档 Source: "docs\*.pdf"; DestDir: "{app}\docs"; Flags: ignoreversion

关键Flags解析：

• ignoreversion: 安装时忽略文件版本检查，通常用于我们自己的程序文件。
• recursesubdirs: 递归复制源目录下的所有子目录和文件。必须与通配符*或特定文件名结合使用。
• createallsubdirs: 在目标位置创建源目录结构中的所有子目录，即使某些子目录是空的。与recursesubdirs配合用于完整复制目录树。
• onlyifdoesntexist: 仅当目标文件不存在时才复制。非常适合用于配置文件，避免安装程序覆盖用户已修改的配置。
• uninsneveruninstall: 卸载时不要删除此文件。慎用，通常用于用户数据。

5.2 使用[Components]节实现可选安装

如果你的软件包包含多个相对独立的部分（如主程序、示例、SDK、离线帮助），可以让用户选择安装哪些组件。

[Components] ; 定义组件 Name: "main"; Description: "主程序"; Types: full compact custom; Flags: fixed Name: "sdk"; Description: "开发工具包 (SDK)"; Types: full custom Name: "examples"; Description: "示例项目"; Types: full Name: "docs"; Description: "离线文档"; Types: full [Files] ; 根据组件条件复制文件 Source: "sdk\*"; DestDir: "{app}\sdk"; Flags: ignoreversion recursesubdirs; Components: sdk Source: "examples\*"; DestDir: "{app}\examples"; Flags: ignoreversion recursesubdirs; Components: examples Source: "docs\*"; DestDir: "{app}\docs"; Flags: ignoreversion recursesubdirs; Components: docs

在安装界面，用户可以在“选择组件”页面勾选或取消勾选sdk、examples等。Types: full compact custom定义了该组件在哪种安装类型下默认被选中（完整、紧凑、自定义）。Flags: fixed表示该组件不可取消选择（如主程序）。

5.3 打包并静默安装系统运行时库

这是打包中最常见的需求之一。例如，用VC++编译的程序需要对应的Microsoft Visual C++ Redistributable。我们可以将这些运行时库的安装程序（如vcredist_x64.exe）打包，并在安装过程中静默运行它。

[Files] ; 将VC++运行库安装程序打包到安装包的临时目录 Source: "redist\vcredist_x64.exe"; DestDir: "{tmp}"; Flags: deleteafterinstall [Run] ; 静默安装运行库。参数 /install /quiet /norestart 是典型静默安装参数，具体需参考对应运行库的文档。 Filename: "{tmp}\vcredist_x64.exe"; Parameters: "/install /quiet /norestart"; StatusMsg: "正在安装 Microsoft Visual C++ 运行库..."; Flags: waituntilterminated

重要经验：

1. 参数务必查证：不同版本的VC++运行库、.NET Framework安装程序的静默参数可能不同。一定要查阅官方文档或使用/?参数查看帮助。常见的静默参数有/q,/quiet,/passive,/norestart等。
2. 错误处理：静默安装失败时，用户可能毫无感知。一个更稳健的做法是检查安装结果。这需要更复杂的[Code]逻辑，例如检查安装程序退出代码，或安装后检查特定注册表键值、文件是否存在。
3. 顺序问题：通常，运行库的安装（[Run]节）应放在主程序文件复制（[Files]节）之后，但在创建快捷方式（[Icons]节）和启动主程序之前。因为主程序运行可能需要这些库。
4. 使用{tmp}目录：将这类一次性安装程序放到临时目录，并用deleteafterinstall标志，安装完成后自动清理，不占用用户安装目录空间。

5.4 处理复杂依赖：以打包Python应用为例

假设你有一个用Python编写的应用，使用PyInstaller打包成了单个exe，但这个exe依赖于一些原生的DLL（如VCRUNTIME140.dll）或数据文件。又或者，你希望直接打包一个便携式Python解释器连同你的脚本。这里给出两种思路的脚本片段。

思路一：打包PyInstaller生成的独立exe及其依赖目录。

[Files] ; PyInstaller生成的主exe（假设是--onefile模式，但可能仍有外部依赖） Source: "dist\myapp.exe"; DestDir: "{app}"; Flags: ignoreversion ; PyInstaller在--onefile模式下也可能需要额外的_dylib或.pyd文件，具体看输出 Source: "dist\*.dll"; DestDir: "{app}"; Flags: ignoreversion Source: "dist\*.pyd"; DestDir: "{app}"; Flags: ignoreversion ; 如果有数据文件或配置文件 Source: "config.ini"; DestDir: "{app}"; Flags: onlyifdoesntexist

思路二：打包便携式Python解释器+你的脚本（虚拟环境）。

[Files] ; 假设你有一个便携式Python环境（如从python.org下载的embeddable package或自己构建的） Source: "python_portable\*"; DestDir: "{app}\python"; Flags: ignoreversion recursesubdirs createallsubdirs ; 你的Python脚本和依赖包（site-packages） Source: "my_script.py"; DestDir: "{app}"; Source: "venv\Lib\site-packages\*"; DestDir: "{app}\python\Lib\site-packages"; Flags: ignoreversion recursesubdirs createallsubdirs [Icons] ; 创建一个启动器，调用便携式Python运行你的脚本 Name: "{group}\我的Python应用"; Filename: "{app}\python\python.exe"; Parameters: """{app}\my_script.py"""; IconFilename: "{app}\myicon.ico" [Registry] ; 可选：将便携式Python路径添加到用户PATH，方便高级用户命令行调用 Root: HKCU; Subkey: "Environment"; ValueType: expandsz; ValueName: "PATH"; ValueData: "{olddata};{app}\python"; Check: NeedsAddPath('{app}\python')

第二种方式更灵活，但更复杂，需要处理好Python路径、模块导入等问题。通常，对于分发给最终用户的Python应用，更推荐使用PyInstaller、Nuitka等工具生成真正独立的可执行文件，再用Inno Setup进行二次打包和配置，这样能减少环境依赖带来的麻烦。

6. 高级脚本技巧与实战避坑指南

掌握了核心功能后，一些高级技巧和细节处理能让你制作的安装包更加专业和健壮。

6.1 条件编译与预处理：一份脚本适配多场景

Inno Setup的预处理器（Preprocessor）非常强大，允许你使用#define定义常量，使用#if等进行条件编译。这在为不同版本（如标准版/专业版）、不同架构（x86/x64）或不同配置生成安装包时非常有用。

; 在脚本开头定义版本和架构 #define MyAppVersion "2.1.0" #define BuildArch "x64" ; 可以是 "x86" 或 "x64" [Setup] AppName=我的应用 #if BuildArch == "x64" AppName=我的应用 (64位) ArchitecturesAllowed=x64 ArchitecturesInstallIn64BitMode=x64 DefaultDirName={autopf64}\我的应用 #else AppName=我的应用 (32位) ArchitecturesAllowed=x86 DefaultDirName={autopf}\我的应用 #endif [Files] ; 根据架构复制不同的文件 #if BuildArch == "x64" Source: "build\x64\MyApp.exe"; DestDir: "{app}" Source: "redist\vcredist_x64.exe"; DestDir: "{tmp}"; Flags: deleteafterinstall #else Source: "build\x86\MyApp.exe"; DestDir: "{app}" Source: "redist\vcredist_x86.exe"; DestDir: "{tmp}"; Flags: deleteafterinstall #endif

你可以通过命令行编译器ISCC.exe传递参数来动态定义这些值：ISCC.exe /DBuildArch=x64 /DMyAppVersion=2.1.0 myscript.iss，从而实现自动化构建。

6.2 自定义安装界面与用户输入

Inno Setup支持使用Pascal脚本创建自定义页面，收集用户输入，例如数据库配置、服务器地址等。

[Code] var CustomPage: TInputQueryWizardPage; ServerName, Port: string; procedure InitializeWizard; begin // 创建一个自定义输入页面 CustomPage := CreateInputQueryPage(wpSelectDir, '服务器配置', '请设置应用连接的服务器信息', '请输入服务器地址和端口号。'); CustomPage.Add('服务器地址:', False); CustomPage.Add('端口号:', False); // 设置默认值 CustomPage.Values[0] := 'localhost'; CustomPage.Values[1] := '8080'; end; function NextButtonClick(CurPageID: Integer): Boolean; begin Result := True; if CurPageID = CustomPage.ID then begin // 验证用户输入 ServerName := CustomPage.Values[0]; Port := CustomPage.Values[1]; if (ServerName = '') or (Port = '') then begin MsgBox('服务器地址和端口号不能为空。', mbError, MB_OK); Result := False; end; end; end; procedure CurStepChanged(CurStep: TSetupStep); begin if CurStep = ssPostInstall then begin // 安装完成后，将用户输入写入配置文件 SaveStringToFile(ExpandConstant('{app}\config.ini'), '[Server]' + #13#10 + 'Host=' + ServerName + #13#10 + 'Port=' + Port + #13#10, False); end; end;

6.3 卸载时的深度清理

默认情况下，Inno Setup会删除安装目录{app}和开始菜单快捷方式。但有些我们创建的东西需要额外清理：

• 注册表：我们之前用uninsdeletekey和uninsdeletevalue标志处理了大部分。
• 环境变量：卸载时，我们应该从PATH中移除添加的路径。这比添加更棘手，因为用户可能在安装后手动修改了PATH。一个相对安全的做法是在安装时备份原始的PATH值到一个特定的注册表位置，卸载时尝试恢复。

[Registry] ; 安装时备份原始的用户PATH Root: HKCU; Subkey: "Software\MyCompany\MyApp"; ValueType: string; ValueName: "OriginalUserPath"; ValueData: "{olddata}"; Flags: uninsdeletekey [Code] procedure CurUninstallStepChanged(CurUninstallStep: TUninstallStep); var OriginalPath, NewPath, AppPath: string; PathArray: TArrayOfString; I: Integer; PathChanged: Boolean; begin if CurUninstallStep = usPostUninstall then begin // 尝试从备份中恢复PATH（简化逻辑，实际应用需更严谨） if RegQueryStringValue(HKCU, 'Software\MyCompany\MyApp', 'OriginalUserPath', OriginalPath) then begin // 这里应该实现一个函数，从当前PATH中精准移除 {app} 路径，而不是简单恢复备份。 // 因为用户可能在安装后修改了PATH。 // 更推荐的做法：在安装时记录我们添加的路径，卸载时只移除它。 // 此处仅为示例，演示思路。 AppPath := ExpandConstant('{app}'); NewPath := RemovePathFromVar(OriginalPath, AppPath); // RemovePathFromVar 是一个需要你实现的函数 RegWriteStringValue(HKCU, 'Environment', 'PATH', NewPath); RefreshEnvironment; end; end; end;

实现一个完美的PATH清理函数比较复杂，需要处理分号分隔、路径格式、大小写等问题。对于要求不高的场景，也可以选择不在卸载时修改PATH，而是在安装程序中提供明确的提示，告知用户如需清理可手动操作。这是一种权衡。

6.4 常见错误排查与调试

• 脚本编译错误：仔细检查脚本语法，特别是[Registry]节中路径的引号、分号。Inno Setup编译器（ISCC）给出的错误信息通常很直接。
• 安装后文件关联/环境变量不生效：
  • 检查注册表路径（Root和Subkey）是否正确，尤其是64位系统上的重定向问题（HKLM\Software\Wow6432Node）。对于32位程序安装在64位系统上，文件关联注册有时需要写到HKCR的特定位置，但Inno Setup的Root: HKCR通常能自动处理。如有疑问，可使用Root: HKLM64或Root: HKCU64显式指定64位视图。
  • 确认环境变量修改后是否广播了WM_SETTINGCHANGE消息。
  • 以管理员身份运行安装程序，特别是操作HKLM时。
• 打包的文件缺失或版本不对：检查[Files]节的Source路径是否正确，是否使用了正确的通配符。在编译前，可以用/O参数指定输出目录，并检查生成的安装包内容（可用7-Zip等工具打开.exe查看内部文件）。
• 静默安装运行库失败：确认静默安装参数是否正确。可以手动在命令行运行打包好的安装程序（如vcredist_x64.exe /install /quiet /norestart）看是否成功。查看Windows事件查看器中的应用程序日志，也可能有线索。

制作一个专业的安装包，远不止是把文件压缩在一起。它关乎用户体验、系统集成和后期维护。Inno Setup以其强大的脚本能力和灵活性，让我们能够精细控制安装过程的每一个环节。从文件关联的图标到环境变量的即时生效，从多组件的可选安装到运行时库的静默部署，每一个细节都需要仔细考量。这份脚本详解和其中分享的踩坑经验，希望能帮你绕过我当年走过的弯路，打造出体验更佳、更可靠的Windows软件安装包。记住，好的安装程序是软件给用户的第一印象，值得你多花些心思。