VS2022升级至17.7后实验实例加载扩展时出现灾难性故障

问题场景 #

将Visual Studio 2022从17.5/17.6版本升级至17.7.4后，调试自行编写的C#扩展时出现以下问题：

• 实验实例加载后弹出错误对话框，提示MaintenanceTaskProcessorPackage包未正确加载
• 后续引发连锁错误，导致实验实例完全无法使用
• 日志文件多次记录扩展加载时的灾难性故障（错误码：HRESULT: 0x8000FFFF (E_UNEXPECTED)）
• 调试器中大量抛出System.Runtime.InteropServices.COMException异常
• 已尝试删除实验文件夹%localappdata%\Microsoft\VisualStudio\17.0_935fe49dExp，或执行devenv.exe /rootsuffix Exp /clearcache、devenv.exe /rootsuffix Exp /updateconfiguration命令，仅能临时解决问题，修改源码重新部署后故障复现

可行解决方案 #

1. 彻底清理扩展项目部署残留 #

• 关闭所有Visual Studio实例（包括实验实例）
• 手动删除扩展项目的bin和obj输出目录
• 打开扩展项目，右键点击解决方案选择清理解决方案，完成后再执行生成解决方案

2. 重置实验实例完整状态 #

• 以管理员身份打开命令提示符，定位到VS安装目录的Common7\IDE文件夹（例：C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE）
• 依次执行以下命令：

  devenv.exe /rootsuffix Exp /resetuserdata
  devenv.exe /rootsuffix Exp /updateconfiguration
  

  注：/resetuserdata会清空实验实例的所有用户配置，执行前确认无需保留相关设置。

3. 修正扩展项目的版本兼容性配置 #

• 打开扩展项目的.csproj文件，确保<VisualStudioVersion>节点设置为17.0或更高版本，与目标VS2022版本匹配
• 检查source.extension.vsixmanifest中的<InstallationTarget>节点，确认版本范围覆盖17.7.x，示例配置：

  <InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0, 18.0)" />
  

4. 排查内置扩展冲突 #

• 启动实验实例时按住Ctrl+Shift组合键，选择安全模式启动
• 若安全模式下实验实例正常运行，说明存在内置扩展冲突，可逐一禁用近期更新的内置扩展，定位具体冲突项

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