visual studio 2022 需通过官方扩展 microsoft visual studio installer projects 才能打包 wpf 应用为 msi 安装程序;安装扩展后添加 setup project,配置文件系统、快捷方式及运行时检测条件,生成并测试 msi 即可。

Visual Studio 本身不内置安装项目模板(尤其是 VS 2022 及以后版本),但可以通过官方扩展 Microsoft Visual Studio Installer Projects 来打包 WPF 应用为标准 Windows 安装程序(.msi)。整个过程不复杂,但需注意几个关键步骤和常见坑点。
安装 Installer Projects 扩展
这是前提,VS 2022 默认不带安装项目支持:
- 打开 Visual Studio → 顶部菜单「扩展」→ 「管理扩展」
- 搜索 “Microsoft Visual Studio Installer Projects”
- 选择对应 VS 版本的官方扩展(由 Microsoft 发布,图标是蓝色齿轮)→ 下载并安装
- 安装完成后重启 Visual Studio
添加安装项目到解决方案
确保你的 WPF 项目已编译通过,再添加安装项目:
- 右键解决方案 → 「添加」→ 「新建项目」
- 搜索 “Setup Project” 或 “安装项目”,选中「Setup Project」模板(不是 Setup Wizard)
- 给安装项目命名(如 MyWpfAppSetup),点击「创建」
- 此时解决方案中会多出一个 .vdproj 项目(旧格式,但目前仍可用)
配置安装项目内容
核心是把 WPF 输出文件、依赖项和快捷方式正确加入安装包:
- 右键安装项目 → 「视图」→ 「文件系统」
- 在「应用程序文件夹」上右键 → 「添加」→ 「项目输出」→ 选择你的 WPF 项目 → 选「主输出」
- 自动带入引用的 DLL(如 Newtonsoft.Json 等),但第三方非 NuGet 引用或本地 DLL 需手动添加
- 右键「用户桌面」或「用户程序菜单」→ 添加「快捷方式」→ 指向「应用程序文件夹」里的主输出
- 如需注册 .NET 运行时检查,可在「检测条件」里添加 .NET Framework 或 .NET Desktop Runtime 的 Launch Condition(推荐用后者,适配 .NET 5/6/7/8)
生成与测试安装包
生成的是标准 MSI 文件,可双击安装、静默部署或用组策略分发:
- 右键安装项目 → 「生成」→ 输出路径默认在 setup 项目文件夹下的 Debug 或 Release 目录下
- 找到生成的 .msi 文件,双击运行测试安装流程(建议在干净虚拟机中验证)
- 安装后检查:是否能启动、图标是否正常、卸载是否干净(控制面板 → 程序和功能)
- 若提示“缺少 DLL”或启动黑屏,大概率是依赖未包含,回退到「文件系统」检查所有必要文件是否已加入
基本上就这些。Installer Projects 是最轻量、兼容性最好的传统方案,适合中小型 WPF 应用发布。如果需要更现代的体验(如单文件、无管理员权限安装),可考虑 Squirrel、WiX Toolset 或 MSIX,但学习成本和配置复杂度明显上升。










