含WinForm组件的VSTO外接程序报RibbonBase.Dispose空引用异常

这个NullReferenceException本质是VSTO Ribbon对象未完成初始化就被GC回收，进入终结器时内部引用为空导致的，和第三方依赖无关：
你集成Windows Forms组件时打乱了VSTO外接程序的默认初始化时序，开发机因为存在Visual Studio注入的VSTO调试钩子、全版本运行时缓存，不会触发时序问题；其他设备上Ribbon实例构造流程被提前加载的WinForm组件中断，RibbonBase内部的核心字段（如RibbonUI、控件集合）还没完成赋值，对象就被垃圾回收标记，最终在终结器线程调用Dispose时触发空引用。
你把代码迁移到正常项目依然复现的原因也很简单：问题出在你迁移过去的Ribbon+WinForm初始化代码本身，和原有项目的配置、引用没有关系。

按顺序做以下调整即可解决问题：

• 给Ribbon类的Dispose方法加空值防护
  你项目里的PrjSpecAddIn.Oberon是Ribbon设计器自动生成的类，默认生成的Dispose方法没有做空判断，直接替换成如下实现：

  protected override void Dispose(bool disposing)
  {
      try
      {
          if (disposing)
          {
              components?.Dispose();
          }
          // 基类核心字段未初始化时，不调用基类Dispose逻辑
          if (this.RibbonUI != null && this.Items != null)
          {
              base.Dispose(disposing);
          }
      }
      catch
      {
          // 屏蔽终结器阶段的非预期异常，避免外接程序被判定为加载失败
      }
  }
  

• 把所有Windows Forms组件的初始化逻辑延后到外接程序启动完成后执行
  90%的同类问题都是因为在Ribbon类的字段声明位置直接实例化WinForm窗体/控件：

  // 错误写法：字段初始化时VSTO宿主上下文还没加载完成，仅在开发机调试环境下能正常运行
  private MainForm mainForm = new MainForm();
  

  把这类声明改成空字段，在ThisAddIn_Startup事件里再做实例化：

  private MainForm mainForm;
  private void ThisAddIn_Startup(object sender, EventArgs e)
  {
      mainForm = new MainForm();
      // 其余业务初始化逻辑都放在这里
  }
  

• 统一目标设备的VSTO Runtime版本
  所有运行外接程序的设备，必须安装和你开发时引用的主版本号完全一致的VSTO Tools for Office Runtime，不要依赖系统预装的版本：不同小版本的RibbonBase内部字段赋值时机有差异，旧版本Runtime下即使初始化时序正常，也可能出现字段未赋值就触发Dispose的问题。
• 关闭Ribbon设计器的自动本地化选项
  打开Ribbon设计器的属性面板，把Localizable属性设置为False：VSTO Ribbon的资源加载逻辑和WinForm的本地化资源加载逻辑存在锁冲突，非开发机缺少对应附属程序集时会直接中断Ribbon构造流程，触发半初始化对象被回收的问题。

修改后用Release模式编译，不要直接在开发机上做卸载重装测试——开发机的VSTO调试缓存会掩盖时序问题，必须在纯净的、没有安装过Visual Studio的虚拟机/测试设备上验证加载流程。

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