在C#项目开发完成后，我们需要把程序打包成安装包，方便在没有开发环境的电脑上安装运行。下面以Visual Studio为例，介绍从零制作msi安装包的整个过程。
一、创建安装项目
打开你的C#解决方案，右键点击解决方案，选择“添加”中的“新建项目”。在模板里搜索“Setup Project”，如果使用的是较老版本VS，可在“其他项目类型”的“安装和部署”中找到“Visual Studio Installer”下的“安装项目”。给项目起名如 MyAppSetup 并确定。
二、添加程序主输出
在解决方案资源管理器中，右键点击刚建的 Setup 项目，选择“添加”然后点“项目输出”。在弹出的窗口里，选择你的主程序项目（例如 WinFormApp），在列表中选择“主输出”，配置选“Release Any CPU”，点击确定。这样编译器会把exe和依赖dll都加进安装包。
三、配置快捷方式与注册表
在 Setup 项目的“文件系统”视图中，可以看到“应用程序文件夹”“用户的程序菜单”“用户桌面”。
- 右键“用户桌面”，选择“创建主输出的快捷方式”，可重命名为软件名，这样装完桌面有图标。
- 右键“用户的程序菜单”同理建立开始菜单快捷方式。
- 若程序需要写注册表，在“注册表”视图里右键相应节点新建键值。
四、设置安装属性
选中 Setup 项目，在属性窗口可修改 ProductName、Manufacturer、Version 和 TargetPlatform（x86或x64）。注意每次大改动版本号要避免升级冲突，可把 RemovePreviousVersions 设为 True。
五、生成安装包
右键 Setup 项目，先“生成”，若无错误，再到“调试”或直接在输出目录 binRelease 下找生成的 msi 和 exe 引导文件。双击 msi 即可在别的机器安装。
常见遗漏点
| 问题 | 原因 | 处理 |
|---|---|---|
| 安装后启动报错缺dll | 未添加内容文件输出 | 添加项目输出中的“内容文件” |
| 桌面无图标 | 未建桌面快捷方式 | 在用户桌面建主输出快捷方式 |
| 32位系统装不上 | TargetPlatform设x64 | 改为x86或对应平台 |
六、简单示例代码辅助理解输出路径
有时我们需要在安装后第一次启动时写本地配置，可用如下C#代码获取安装目录：
using System;
using System.IO;
using System.Windows.Forms;
namespace WinFormApp
{
public class InitHelper
{
// 获取当前exe所在目录，即安装目录
public static void WriteDefaultConfig()
{
string baseDir = AppDomain.CurrentDomain.BaseDirectory;
string cfgPath = Path.Combine(baseDir, "config.ini");
if (!File.Exists(cfgPath))
{
File.WriteAllText(cfgPath, "lang=zh-CN");
MessageBox.Show("已写入默认配置");
}
}
}
}
上面的代码演示了如何在新装软件首次运行时，于安装目录生成配置文件，避免用户手动创建。
七、使用命令行自动打包
若想接入持续集成，可用 msbuild 命令生成安装项目：
# 使用VS自带构建工具编译安装项目 msbuild MyAppSetup.vdproj /p:Configuration=Release
需要注意 vdproj 不能用普通 dotnet build，必须用完整版 msbuild 且装有 Visual Studio Installer 组件。
小结
整体流程就是建安装工程、加主输出、配快捷方式、设属性、生成 msi。只要依赖项齐全、平台匹配，打包发布就不是难事。按照本文步骤操作，你也能轻松把 C# 程序变成标准安装包。