You need to enable JavaScript to run this app. VSIX项目升级.NET及包后点击扩展按钮报Microsoft.VisualStudio.Threading加载失败
优惠活动
大模型
产品
解决方案
定价
更多

VSIX项目升级.NET及包后点击扩展按钮报Microsoft.VisualStudio.Threading加载失败

问题背景
  • 项目类型:VSIX扩展项目,通过Command命令工具实现文件创建功能
  • 变更操作:将项目目标.NET Framework从4.6.1升级至4.7.2,同步升级项目依赖NuGet包,变更后的包列表可参考随附截图
  • 异常现象:项目启动调试流程完全正常,点击扩展对应功能按钮时触发运行时错误,错误界面可参考随附截图。错误日志明确提示:

无法加载文件或程序集Microsoft.VisualStudio.Threading, Version=16.8.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a,或其某个依赖项

  • 已完成排查:确认Microsoft.VisualStudio.Threading NuGet包已添加到项目引用列表
排查解决步骤
  • 调整引用的「复制本地」属性
    在项目引用列表中选中Microsoft.VisualStudio.Threading,打开属性面板将「复制本地(Copy Local)」设置为False。VSIX运行在Visual Studio的应用域内,VS本身已内置对应版本的基础框架程序集,若开启复制本地属性,会将项目内引用的程序集强打包进VSIX包内,反而引发版本不匹配的加载失败问题。
  • 检查程序集绑定重定向配置
    打开项目对应的App.config文件,确认是否存在Microsoft.VisualStudio.Threading的绑定重定向配置。按照当前调试所用VS版本内置的程序集实际版本,将所有旧版本的重定向条目统一指向VS内置的最高兼容版本,避免CLR按照固定指定版本号加载程序集时找不到匹配项。
  • 校验VSIX清单的资产声明
    打开项目根目录下的source.extension.vsixmanifest文件,切换到资产配置页,删除所有错误声明的、将Microsoft.VisualStudio.Threading标记为扩展私有依赖的条目。这类VS原生基础程序集无需作为扩展私有资产打包,错误声明会导致加载路径匹配失败。
  • 清理缓存重新生成项目
    手动删除项目路径下的bin、obj编译缓存文件夹,同时删除VS实验 hive路径下的旧扩展残留文件(通常位于%LocalAppData%\Microsoft\VisualStudio\<VS版本ID>\Exp\Extensions目录),重新生成VSIX项目后再复现错误操作。
  • 对齐依赖SDK版本与目标VS版本的兼容范围
    核对当前引用的Microsoft.VisualStudio.Threading包版本,与调试所用VS的内置程序集版本是否在兼容区间内:如果调试环境为VS2019(16.x版本),不要引用超出VS内置版本上限的Threading包,避免CLR找不到指定版本的程序集。

内容的提问来源于stack exchange,提问作者Murat Kurtboğan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 19:15:04