如何安装WIX Toolset V5版本？现有V3升级安装问题求助

一、清理旧版WIX v3残留 #

• 打开控制面板「程序和功能」，卸载已安装的WIX Toolset v3
• 打开Visual Studio，进入「扩展>管理扩展>已安装」，卸载WIX v3对应的Heatwave扩展
• 清理NuGet本地缓存：打开命令提示符，执行 dotnet nuget locals all --clear

二、安装WIX Toolset V5核心工具 #

• 搜索「WIX Toolset V5 官方安装包」，下载适配你系统的版本（x64/x86）
• 运行安装包，务必勾选「Visual Studio Integration」选项，确保VS能识别v5项目模板
• 安装完成后重启Visual Studio

三、安装VS Heatwave for WIX v5扩展 #

• 打开Visual Studio，进入「扩展>管理扩展>联机」，搜索Heatwave for WiX v5
• 下载并安装该扩展，安装完成后再次重启VS，此时新建项目窗口就能看到WIX v5的模板

四、解决NuGet仅显示v3的问题 #

• 检查NuGet包源：打开VS「工具>NuGet包管理器>包管理器设置」，在「包源」中添加官方源：https://nuget.wixtoolset.org/v3/index.json
• 若仍搜不到v5包，直接在NuGet包管理器控制台执行指定版本安装命令：Install-Package WixToolset -Version 5.0.0（可替换为最新稳定版号）

五、迁移现有v3项目到v5 #

• 打开现有WIX v3项目，右键项目>属性>WiX Toolset，将「Toolset Version」切换为v5
• 修复项目中API兼容问题（WIX v5部分API与v3不兼容，可参考官方迁移说明调整代码）

内容的提问来源于stack exchange，提问作者Sijith