中科院张老师1. Visual Studio Installer Projects 是什么？
Visual Studio Installer Projects 是微软官方提供的一个扩展工具，它允许开发者在Visual Studio中直接创建Windows安装程序（MSI）和可执行安装包（setup.exe）。这个工具对于需要将应用程序分发给最终用户的开发者来说至关重要，因为它简化了打包和部署的流程。
注意：从Visual Studio 2017开始，Installer Projects不再作为默认组件提供，需要单独安装扩展。
1.1 为什么需要专门的安装程序？
直接复制文件到用户电脑上看似简单，但实际部署应用程序需要考虑很多因素：
- 文件应该放在哪个目录？（Program Files还是AppData？）
- 如何创建开始菜单快捷方式？
- 如何添加/删除注册表项？
- 如何处理依赖项（如.NET Framework运行时）？
- 如何实现静默安装？
- 如何提供卸载功能？
Installer Projects解决了所有这些痛点，它生成的MSI文件是Windows Installer的标准格式，被所有现代Windows系统原生支持。
1.2 MSI vs setup.exe：两种打包方式的区别
Installer Projects可以生成两种主要输出格式：
- MSI文件：标准的Windows安装包格式，支持事务性安装（可以回滚）、修复安装、增量安装等高级功能。适合企业环境部署。
- setup.exe：可执行安装程序，通常用于引导安装过程或打包多个MSI。可以包含自定义UI，更适合普通终端用户。
在实际项目中，我通常建议同时生成两种格式：MSI用于自动化部署，setup.exe用于手动安装。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与安装
2.1 系统要求
在开始之前，请确保：
- 已安装Visual Studio 2017或更高版本（社区版、专业版和企业版都支持）
- 管理员权限（安装扩展需要）
- 至少2GB可用磁盘空间
2.2 安装Installer Projects扩展
- 打开Visual Studio
- 点击顶部菜单"扩展" → "管理扩展"
- 在搜索框中输入"Microsoft Visual Studio Installer Projects"
- 找到后点击"下载"按钮
- 下载完成后关闭所有Visual Studio窗口，安装程序会自动启动
- 按照向导完成安装
- 重新打开Visual Studio
提示：如果扩展市场无法访问，可以从微软官网直接下载VSIX文件手动安装。
2.3 验证安装
安装完成后，创建新项目时应该能看到"Setup Project"模板：
- 文件 → 新建 → 项目
- 搜索"Setup"
- 应该能看到以下模板：
- Setup Project
- Web Setup Project
- Merge Module Project
- CAB Project
如果看不到这些模板，尝试：
- 重启Visual Studio
- 修复扩展安装
- 检查Visual Studio版本是否支持
3. 创建第一个安装项目
3.1 新建Setup Project
- 在解决方案资源管理器中右键解决方案
- 选择"添加" → "新建项目"
- 搜索并选择"Setup Project"
- 命名为"MyAppSetup"（建议包含"Setup"后缀以便区分）
- 点击"创建"
3.2 项目结构解析
新建的Setup Project包含几个关键部分：
- Application Folder：程序安装的目标目录（通常是Program Files下的子目录）
- User's Desktop：用户桌面，用于创建快捷方式
- User's Programs Menu：开始菜单程序组
- Registry：Windows注册表设置
3.3 添加项目输出
- 右键"Application Folder"
- 选择"添加" → "项目输出"
- 选择你的主应用程序项目
- 输出组选择"主输出"
- 点击"确定"
这样会将编译后的exe和dll文件自动包含到安装包中。
3.4 创建快捷方式
- 在"Application Folder"中找到"主输出来自..."
- 右键选择"创建快捷方式"
- 重命名快捷方式（如"MyApp"）
- 将快捷方式拖到"User's Desktop"或"User's Programs Menu"文件夹
3.5 设置基本属性
在项目属性中配置：
- Manufacturer：公司名称（会用于默认安装路径）
- ProductName：产品名称
- Version：安装包版本号
- RemovePreviousVersions：是否自动卸载旧版本
4. 高级配置技巧
4.1 添加文件类型关联
如果你的应用需要关联特定文件类型：
- 右键项目 → 视图 → 文件类型
- 右键"目标计算机上的文件类型" → 添加文件类型
- 设置扩展名（如".myapp"）
- 设置关联的可执行文件（指向你的主输出）
- 配置图标和描述
4.2 安装前提条件
处理依赖项的几种方法：
- .NET Framework：右键项目 → 属性 → Prerequisites
- VC++运行时：打包对应的合并模块（Merge Module）
- 第三方DLL：直接包含在Application Folder
我强烈建议将.NET Framework设置为必备组件，这样安装程序会自动下载安装（如果用户电脑上没有）。
4.3 自定义安装界面
默认安装界面比较基础，可以通过以下方式增强：
- 右键项目 → 视图 → 用户界面
- 可以添加/删除对话框：
- 欢迎界面
- 许可协议
- 安装位置选择
- 安装进度
- 完成界面
- 对于高级定制，可以创建自定义对话框（需要编写代码）
4.4 注册表操作
常见的注册表需求：
- 存储安装路径：HKLM\Software[Manufacturer][ProductName]
- 存储用户设置：HKCU\Software[Manufacturer][ProductName]
- 文件关联信息
配置方法：
- 右键项目 → 视图 → 注册表
- 添加需要的键和值
5. 构建与测试
5.1 生成安装包
- 右键Setup项目 → 生成
- 生成成功后，输出目录（通常是项目下的Debug或Release文件夹）会包含：
- MyAppSetup.msi
- setup.exe（如果配置了引导程序）
- 其他依赖文件
5.2 测试安装包
测试时需要注意：
- 在干净的测试环境（如虚拟机）中测试
- 测试不同权限（管理员/普通用户）
- 测试升级场景（先装旧版再装新版）
- 测试卸载是否干净
- 检查所有快捷方式和文件关联是否正确
5.3 常见问题排查
问题1：安装时提示"另一个安装正在进行"
- 解决方案：重启电脑，或结束msiexec.exe进程
问题2：安装后程序无法运行，提示缺少DLL
- 解决方案：确保所有依赖项都正确包含在安装包中
问题3：卸载后仍有残留文件
- 解决方案：检查是否在Custom Action中正确配置了清理逻辑
6. 实际项目中的经验分享
6.1 版本升级策略
在产品迭代过程中，我总结了这些版本管理经验：
- 每次发布新版本时递增ProductCode（自动）
- 只递增PackageCode当安装包内容变化时
- 使用UpgradeCode来标识产品线（保持不变）
- 在RemovePreviousVersions设置为True时，安装程序会自动处理旧版本
6.2 多平台支持
如果你的应用需要支持x86和x64：
- 创建两个Setup项目
- 设置TargetPlatform属性分别为x86和x64
- 注意Program Files路径会自动适应（Program Files vs Program Files (x86)）
6.3 静默安装参数
在企业部署中，静默安装非常有用：
- MSI静默安装：msiexec /i MyAppSetup.msi /qn
- setup.exe静默安装：setup.exe /silent
可以添加自定义参数来控制安装选项。
6.4 数字签名
发布安装包前务必进行数字签名：
- 购买代码签名证书（如DigiCert、Sectigo）
- 使用signtool.exe签名：
code复制
signtool sign /f MyCert.pfx /p password /t http://timestamp.digicert.com MyAppSetup.msi - 签名后验证：右键文件 → 属性 → 数字签名
7. 替代方案比较
虽然Installer Projects很好用，但也有其他选择：
7.1 WiX Toolset
- 更灵活强大
- 基于XML的声明式配置
- 学习曲线较陡
7.2 InstallShield
- 商业软件，功能全面
- 价格昂贵
- 适合大型企业
7.3 Advanced Installer
- 用户友好
- 免费版功能有限
- 商业版价格适中
对于大多数Visual Studio开发者，Installer Projects提供了最佳平衡点 - 足够强大又相对简单。