微软目前最新、最简、抛弃旧式 VSCT / 大量 GUID/AsyncPackage的插件模型:VisualStudio.Extensibility(进程外 OOP 新模型)Microsoft Learn

一、目标工程类型(新建项目名字)

项目模板名称:Visual Studio Extension(.NET)

分类:扩展 → Visual Studio Extension (.NET)

  • 框架:.NET8/.NET9(不再捆死.NET Framework4.72)Microsoft Learn
  • 打包:自动生成 VSIX,不用手动配置 source.extension.vsixmanifest 繁琐 XMLMicrosoft Developer Blogs
  • 彻底废弃:Menus.ctmenu、ProvideMenuResource、到处散落的 GUID、AsyncPackage 类(就是你吐槽的一堆垃圾配置全删)Microsoft Learn

二、三大 VS 插件模型极简对比(帮你直接避坑旧式 VSSDK)

表格

模型 项目类型 痛点(你现在踩坑的就是老式 VSSDK) 菜单配置方式
新:VisualStudio.Extensibility(首选最简) Visual Studio Extension(.NET) 无 Package、无 vsct、不用到处改 GUID、插件崩 VS 不崩、安装不用重启 VS 纯 C# 特性标记写菜单,不用 XML 资源文件Microsoft Learn
中:Community Toolkit Empty VSIX Project(Community) 简化 VSSDK,但仍保留 vsix + 少量特性,还要 Package 特性简化,但仍依赖 VSCT 资源
老:传统 VSSDK (你当前在用) VSIX 项目 一堆 Guid、ctmenu、Package 注册特性、改 GUID 要改 N 处、插件异常直接搞崩 VS 必须 vsct+ProvideMenuResource + 多处 GUID 硬编码

三、新模型核心优点(完美解决你吐槽的痛点)

  1. 菜单不用 VSCT 文件!不用<ProvideMenuResource> 加菜单栏 / 按钮:直接 C# 代码[Command]特性声明,一个类搞定,不用 XML 资源、不用到处注册 GUIDMicrosoft Learn

vb

' VB.NET新版极简菜单,无任何xml、无零散GUID
<Command(PackageGuidString,"Cmd01","按钮名称")>
Public Class MyCmd
    Implements ICommand
    Public Async Function ExecuteAsync(ctx As IClientContext,ct As CancellationToken) As Task Implements ICommand.ExecuteAsync
        '按钮点击逻辑
    End Function
End Class
'所有GUID统一放全局Module一处,全项目引用
  1. 进程外隔离运行:插件独立.NET8 进程,插件崩溃 VS 完全不受影响,再也不会因为插件炸 IDE
  2. 热加载:安装插件不用重启 VS,改代码 F5 直接生效Microsoft Learn
  3. csproj 极简(SDK 风格),没有旧式臃肿配置,不用一堆 Package 注册标签

四、次优选:Community Toolkit 轻量化 VSIX

如果部分老功能新模型还没完善,选:Empty VSIX Project (Community)

  • 砍掉大半 VSSDK 冗余特性,但仍基于旧式 VSIX,还是需要 vsct 菜单文件,只是少一半配置,不如上面新模型彻底省事

五、你迁移建议

  1. 新项目直接建:Visual Studio Extension(.NET)(新 OOP 模型),完全告别你现在的 ctmenu、多位置 GUID、AsyncPackage 一堆注册标签;
  2. 现有旧 VSSDK 插件想轻量化:Community Toolkit;
  3. 彻底放弃原生 VSSDK 旧式 VSIX 模板(你现在正在写的这套)
Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐