NSIS是功能强大的安装包制作工具，但其高质量的教程稀少，上手困难。且官方文档罗列知识点，很难组合成实际用法。作者认为比起手册式写法，更需要从使用的角度出发的文章，在过程中引入概念和用法，更符合人学习的思维。

来自官方的介绍：

NSIS (Nullsoft Scriptable Install System) 是 Windows 下的一个安装程序创建工具，它允许程序员来创建这样的安装程序。

NSIS 创建的安装程序能够安装、卸载、设置系统设置、解压文件等等。 因为它基于脚本文件，你可以完全的控制安装程序的每一部分。 脚本语言支持变量、函数、字串操作，就像一个普通的程序语言一样 - 但是设计来创建安装程序。 即使有那么多的特性， NSIS 仍然是最小的安装程序系统。在默认选项下，它仅增加了 34 KB 的开销。

在官网下载NSIS安装包。安装后将安装路径加入系统环境变量，如：C:\Program Files (x86)\NSIS。在命令行中输入nsis或makensis测试是否工作。

本文同时提供有一个示例项目，它包含在文档中内容的代码示例，包括几个示例项目，可以对照脚本与文章内容，会更容易理解到如何使用NSIS。

项目对应关系如下表：

创建代码文件

NSIS脚本文件的拓展名是.nsi，我们创建一个 installer.nsi，文件名可以随意取。一般为要打包的程序名称，本文示例为了不产生误解取为 installer。

.nsi文件可以使用任何文本编辑器打开，建议使用vscode打开，安装NSIS的插件编写更加方便。

在文件中添加一个安装区段

installer.nsi

这里引入一个区段的概念，区段内包含安装或卸载过程的逻辑，用于组织不同的安装内容，有以下重要特点：

区段由Section和SectionEnd组成，Section行中参数依次为：区段名、区段的唯一标识码。代码中Section1为区段名，SEC01为区段的唯一标识码，用于其他地方操作区段的标识使用。官方文档

添加输出文件和安装代码

installer.nsi

有了安装区段后，还必须设置一个输出文件，告诉NSIS编译器安装包的输出位置。在installer.nsi的开头加入下面这行代码：

这里使用了一个属性命令OutFile，它是必须有的命令。指定生成的安装包的路径和名称，可以设置相对路径与绝对路径。当只有名称时，生成文件与.nsi文件同目录。

OutFile 是必须的命令，指定编译器输出安装包的路径。使用方式如下：

💡Tip1: 这里用到了命令，命令分为安装程序属性命令和编译器命令

💡Tip2: 这里用到了;，它和#一起在NSIS的脚本中作为注释符，后跟注释内容

安装程序属性命令用于指定安装包相关的属性值，编译器命令用于指定编译器在编译时的选项。

Section中使用了两个指令SetOutPath和File，前者用于指定后续指令的输出目录，后者用于指定安装包在打包时要包含进那些文件，且在安装时要将这些文件安装到前者指定的目录中去。

Tip: 这里用到的两个指令都是基础指令，指令还有很多种类型，它们都需要包含在区段或函数中才能运行。与命令的区别是，命令都在编译安装包时运行，指令在安装或卸载时运行。

🌟知识点🌟

SetOutPath 使用了一个值 [INSTDIR](https://www.nsisfans.com/help/Section4.2.html#4.2.2)，这是一个已经被声明的变量。变量用来临时存储一些值，它可以被改变，在变量名前面加上``符号使用，自定义的变量要自己声明。查看文档变量了解更多。

💡Tip: 这里有个注意点，$INSTDIR 前后用引号包起来了。这是因为在NSIS里，数值和字符串用法都是一样。区别的方式就是字符串值在使用时，用引号包起来，不然默认会被当成数值处理。

执行脚本编译安装包

这样就完成了一个最简单的脚本文件，在命令行中执行：

注：如果提示没有找到makensis，那你可能是没有设置nsis的环境变量

本章代码在示例项目中对应base项目的installer.nsi，可以将本章内容与代码对照，会更容易理解到如何使用NSIS。

安装程序属性主要控制安装程序的：程序信息、图标、默认安装目录、外观、安装界面文本、页面、包含的文件。

这里主要介绍常用到的属性（如下例），更多的属性设置在官方文档中可以查到。

常用的设置安装属性的命令都是编辑时命令，更多属性和特殊用法查看安装程序属性：

🌟基础语法🌟

!define是定义常量值的命令，它是一个编译时命令。常量定义好后不能改变值，定义后的常量使用 ${常量名}进行使用。如示例代码中的：${PRODUCT_NAME}

添加安装程序信息

Name 设置安装程序的名称。

注意：当名称中使用了&符号时，就需要传入第二个参数“双&名称”，将第一个参数名称中的&用两个&表示。

Icon 设置安装程序的图标，图标文件后缀名为.ico。

InstallDir 设置默认安装目录。

💡Tip: $PROGRAMFILES 是一个NSIS定义的变量的常量，说是常量其实就是NSIS的提供的系统环境变量，用于获取各种路径。使用方式与变量相同，查看变量的常量章节了解可以使用的值。

安装程序版本信息类

VIAddVersionKey与VIProductVersion共同决定安装程序的版本信息，前方示例代码设置的属性在文件信息上看就是这样了。官方文档

大部分的安装包都是有着完善的安装过程，它往往由几个界面组成：

由于古典界面过于的古典，所以简单介绍一下，应该基本不会在当代的主流安装UI中被需要。

使用Page命令指定安装过程要包含的界面，UninstPage命令指定卸载过程界面，通过调整前后顺序来排列安装界面的顺序。中文文档

古典安装界面风格：

现代UI简称为MUI，是NSIS安装包最流行的UI库，文档链接

💡💁🗒️Tips: 后续文档中的UI不做特别说明，默认为MUI。

NSIS自带MUI，所以直接引用进来：

先进行基础设置，MUI_ABORTWARNING常量标志关闭安装程序窗口时给出警告提示，MUI_ICON常量是MUI安装程序和界面的logo图标，在作用上替代了前文中Icon 命令。

再设置MUI的界面，使用 insertmacro关键字导入不同界面的宏定义。

这里用到了insertmarco关键字和macro(宏)的概念，宏常用于组织安装与卸载的代码片段。

🌟Tips: 与区段不同的是，宏用于将可重复使用的脚本片段，在各个需要的地方用!insetmarco标记插入位置。宏命令是在编译时插入代码，这样你只需要写一份通用的代码，就可以多处的使用。

MUI的界面风格如下：

!

这样安装界面就定义完成了，可以根据自己的喜好删减和排列不同的界面。

但请注意，如果只有安装界面并不能成功编译出安装包，我们还需要定义卸载程序。

有安装程序，那么与之对应的就是卸载程序。卸载程序对应着我们的程序的卸载过程，对于常规软件来说，必提供卸载程序给用户方便卸载。

🌟Tips: 卸载属性必须在所有安装和卸载页面之前定义。

MUI_UNICON常量指定卸载程序使用的图标。

不同于安装程序，卸载程序包含在安装程序内被一起安装，在安装后运行进行卸载，所以NSIS要求我们在安装的Section中定义卸载程序，由编译器生成。

并且，需要至少编写一个卸载区段，作为卸载程序的执行内容。这里使用唯一特殊的卸载区段Uninstall，这是一个特殊的卸载区段名称，可以不用加un.的前缀。

与安装界面同理，我们给卸载程序加入和界面。

最后设置界面使用的语言，🚨需要注意的是，语言设置必须放在所有安装和卸载界面之后，不然编译会出现一个错误，或别的未知错误。

🌟Tips: 这里涉及到一个代码顺序的问题，NSIS是顺序执行的，所以代码顺序十分重要。因为MUI在使用中包含宏代码，而它的宏代码中的变量又有前后关系，所以使用MUI的过程中会经常遇到一些因为代码顺序导致的问题。

在安装程序中，安装与卸载是伴生关系，一般编写了什么安装内容，就需要编写与之相应的卸载内容。

本章代码在示例项目中对应install项目的installer.nsi，可以将本章内容与代码对照，更直观的理解如何编写安装与卸载内容。

从这里开始，我们将前文中Section1中的安装内容移动到Sectionmyapp中进行默认安装。与特定的卸载Section名称Uninstall不同的是，安装Section并没有特定的Section名称，一般我们将程序默认安装内容的Section命名为程序的名称(如: myapp)或者Post，也可以按自己意愿命名。

我们在安装时增加了SetOverwrite命令(文档)，这是一个编译器标记命令，它指示编译器后续代码中File指令的覆盖方式（如果存在），ifnewer 值表示当文件更新时覆盖安装。

🌟Tips: NSIS中常常会用用到一些标记类的命令，他们经常需要在后续代码需要什么标记时进行设置，可以在多处设置不同的值。有成对的出现的情况，在设定非常规标记值后，在代码块后再将其设置回来，可以根据需要灵活搭配。

安装中包含了File的常见的几种用法：

注意：File指令中的文件路径可以是绝对路径、相对路径或者文件名。安装位置的的相对路径和文件名相对于当前SetOutPath指定的目录，需要安装文件的相对路径和文件名相对于当前执行脚本的目录。更多详实信息查看文档

与安装相对应的的卸载过程，在无特殊需求的情况下，卸载则需要将安装的文件卸载干净，SectionUninstall中包含了卸载时常用的指令：

一般的做法是，与安装的顺序对应，依次删除安装的文件，最后删除整个安装目录。

绝大部分的安装程序都会往桌面和开始菜单中生成安装程序的图标，这是我们的程序安装后便于使用的重要形式。

安装桌面快捷方式

我们先往Section myapp尾部中加入下列代码：

使用CreateShortCut指令创建前面使用File指令安装的可执行程序的快捷方式到桌面上。

CreateShortCut 生成的桌面图标默认采用指向的可执行程序的图标。如果之前生成过同名快捷方式，而图标不同，那么生成的新桌面快捷方式图标可能不会更新，需要刷新一下桌面或者注销用户重新登录才可以。

安装开始菜单快捷方式

再往Section myapp尾部中加入下列代码：

同理，创建开始菜单快捷方式也是使用CreateShortCut在系统的指定目录下创建可执行程序的快捷方式。

这里我们在$SMPROGRAMS常量表示的开始菜单目录下使用CreateDirectory创建了产品名称的目录，再在其中创建快捷方式。

这种在开始菜单中创建产品目录，然后再在其中放置快捷方式的方式是常规做法。也可以直接将快捷方式直接创建在开始菜单根目录中，这里自由度很高，可以根据需要自行选择。

🌟知识点🌟

这里通过IfFileExists指令来判断路径是否已经存在，它是一个流程控制指令，用法是：

位置可以指定行偏移或者标记，行偏移使用 +/-数值或者0，正数值代表从本行起向后的第几行，负数值代表从本行起向前的第几行，0代表从本行起继续执行。

如下例判断记事本程序是否已经安装在操作系统目录下，存在从改行顺序执行弹出 MessageBox。不存在则向后记2行开始执行，跳过MessageBox。

指定标记则使用标记名称，直接跳转到标记的代码行开始执行，例如：

Tips: 这样的判断指令跳转的方式在NSIS还有一些，他们都是同样的使用方式，效果与Goto一致。

卸载快捷方式

与安装文件同理，安装了快捷方式后同时也要编写卸载过程。使用Delete与RMDir指令删除桌面和开始菜单中的快捷方式。

在Windows中，正规的软件在安装后，都可以在win7的控制面板或者win10的安装的应用内找到，供用户很方便的可以查看安装信息和卸载。

但，这并不是Windows自动检测到安装并记录的，而是一个君子协定，需要安装程序自觉进行注册后才能在已安装的列表内找到。（如果你不注册也没人来打你😜

代码如下：

这里使用指令WriteRegStr添加注册表字符串值，它是一个注册表指令。基础语法如下：

💡 注册表的rootkey可以为下列内容，他们分别记录着windows中的不同内容，常用HKLM为本机内容（一般用来记录为所有用户的信息），HKCU为当前用户。

💡subkey为具体注册表项相对于rootkey的全路径，下图中的路径框中的 SOFTWARE\BiliBili 就是subkey。

🌟Tips: 如果子项并不存在，WriteRegStr 会将其创建。

在 SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall{程序名} 这个注册表项下创建指定的 DisplayName、InstallDir、UninstallString、DisplayIcon、DisplayVersion、URLInfoAbout、Publisher这些值告诉Windows我们安装的程序信息。然后，我们就可以在安装的程序列表内看到已安装的程序信息。

💡Tips: $(^Name) 用于获取Name命令设定的值

类似的添加注册表值的指令还有：WriteINIStr、WriteRegBin、WriteRegDWORD、WriteRegExpandStr。更多注册表操作可以参考文档。

与其他安装过程同理，安装写入了注册表，那么就需要在卸载的时候清理干净。

受国产软件的荼毒，很多人不喜欢卸载完成之后还要点击完成，总觉得会被装上莫名其妙的软件。如果你也不喜欢这样，那么请在卸载的内容里设置卸载完成自动关闭。

NSIS提供了一系列的命令用来设置基础界面信息，以下列举最常用的，更多的见文档。

窗口标题

Caption自定义安装程序的窗口标题。安装程序标题默认为 {Name命令指定的名称} Setup，如果你不喜欢可以自己设置。

底部分割线文本

BrandingText设置安装窗口内容底部分割线上的文本。如果设置空字符串("")，则显示下图中默认值；如果不想在这里显示文本，设置只有一个空格的字符串" "就行。

退出警告

如果你需要在用户点击关闭按钮退出安装程序时进行提示，那么就加入下面这行代码：

弹出提示窗：

顶部右侧图标

安装过程界面的顶部右侧可以设置图标，默认为NSIS的logo。我们自己程序的安装包肯定是是替换它的，通过定义下列常量来实现：

效果图如下：

定义MUI_WELCOMEFINISHPAGE_BITMAP常量的值为图片路径，格式限定为(.bmp)。图片区域尺寸为164*314，推片最好是区域尺寸的倍数，不然可能会被裁剪。

💁Tips: 一般在使用库时，定义其指定常量要在宏的前面，因为宏内代码会使用到其相关常量。

效果图如下：

一般License界面我们定义用户需要勾选确认，而不是直接点击Agree就进入下一步了。在导入Lincese界面宏之前，定义MUI_LICENSEPAGE_CHECKBOX常量，设定必须点击同意选项了之后才能继续进行下一步。

效果图如下：

组件界面在实际使用中不是一个非必须的界面，在有一些可选的内容需要用户选择性安装时才需要这个界面，选择安装列表显示所有可见的Section。反之，不需要的话就移除Components page 。

组件界面的文字信息很多，我们一般定义顶部的标题(MUI_PAGE_HEADER_TEXT)和文本(MUI_COMPONENTSPAGE_TEXT_COMPLIST)，与选择框的标题文本(MUI_PAGE_HEADER_SUBTEXT)。

效果图如下：

但是在实际安装包中，我们需要调整Component界面的布局。因为它默认的这个界面布局实在是利用率很低，无关信息和空白间距太多了。

我们可以通过NSIS提供的功能将默认的界面改变成下图的的样子：

主要使用的是GDI设置方式，如果对GDI开发比较熟悉的读者将会很容易理解。下面将逐步介绍调整过程：

(1) 定义界面加载函数

通过GDI调整界面的布局，首先需要界面先完成显示。定义MUI_PAGE_CUSTOMFUNCTION_SHOW常量为一个函数ComponentsPageShow，我们将GDI的操作代码写入这个函数中，它将在组件界面显示后调用。

🌟重点注意🌟：MUI_PAGE_CUSTOMFUNCTION_SHOW是一个MUI定义的自定义函数宏，它不特殊针对某一界面，而是在其定义后插入的第一个MUI界面宏中生效。所以，想要为一个界面设定界面显示后调用的函数，就请将这个常量定义在该界面宏的前面。同类的几个函数常量还有MUI_PAGE_CUSTOMFUNCTION_PRE 、 MUI_PAGE_CUSTOMFUNCTION_LEAVE 、 MUI_PAGE_CUSTOMFUNCTION_DESTROYED，详见官网"Page Custom Functions"章节 。

💡知识点：函数类似于区段，常用于组织可复用的安装过程。函数只能在区段中被调用，跟区段一样区分安装函数与卸载函数，不能混用。

(2) 隐藏头部区域的次级文本

使用FindWindow指令获取安装窗口的句柄，#32770 是安装程序的窗口在windows中注册的类名。

使用GetDlgItem指令获取指定控件的句柄，使用ShowWindow指令设置指定句柄控件的显示/隐藏。

💡句柄来源：可以在NSIS安装路径下的 "Contrib\Modern UI 2\Pages" 中的代码文件中找到每个界面上的UI控件句柄。

结果：

(3) 隐藏内容区域的主文本

结果：

(4) 隐藏安装类型选择文本和控件

安装类型选择默认下没有显示，但是界面上空出了它的位置，为了避免调整UI受到干扰，我们需要将其一并隐藏。

💡安装类型在额外进行配置了后才会出现（用的比较少），常见于驱动程序安装时选择完整安全、典型安装还是自定义安装。

结果：

(5) 隐藏描述标题文本

组件描述区域显示鼠标指向的组件列表中组件的描述文本，描述标题文本表示环绕描述文本的一个框和框上的标题文本。

💡标题文本本质上是一个GroupBox，但是它和描述文本只是前后叠在了一起，并没有包含关系。所以，隐藏了描述文本并不影响描述文本的显示。

结果：

(6) 调整组件列表标题和组件列表

我们将组件列表文本和组件列表移动到左上角，并调整尺寸大小。

使用NSIS自带的 System.dll 库的 Call 函数调用 Windows 系统函数 SetWindowPos 设置GDI控件的位置和尺寸。System::Call 函数的用法详见文档，SetWindowPos 函数的用法详见MSDN文档。

NSIS可以调用C标准库中的函数，语法为 [dll名]::[函数名]

💡重点注意：SetWindowPos 从第3位参数到第6位为 x, y, cx, cy，x,y 为控件的左侧像素坐标和上侧像素坐标，相对原点为当前区域的左上角。cx,cy 为控件的像素宽高。

结果：

(7) 移动磁盘占用文本和描述文本

我们将组件列表文本和组件列表移动到左上角，并调整尺寸大小。

结果：