如何在同一自定义Ribbon选项卡下安装多个VSTO Addin？

我帮很多VSTO开发者解决过这个问题——要让多个Add-in共用同一个Ribbon选项卡，关键是放弃Visual Studio的可视化Ribbon设计器，改用Ribbon XML的共享命名空间+idQ属性机制，Office会自动识别并合并这些控件。具体操作步骤如下：

1. 统一使用Ribbon XML替代可视化设计器 #

Visual Studio的可视化Ribbon设计器会为每个Add-in生成独立的选项卡定义，无法实现共享。所以所有要共用选项卡的Add-in，都要添加**Ribbon (XML)**项（而不是Ribbon (Visual Designer)）。

2. 定义全局共享的命名空间 #

所有Add-in的Ribbon XML文件，都要在<customUI>标签里指定同一个唯一的命名空间，比如：

<customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui" namespace="MyCompany.Excel.SharedAddins">

这个命名空间要足够独特，避免和其他第三方Office插件冲突。

3. 第一个Add-in创建基础选项卡 #

在第一个Add-in的Ribbon XML里，定义“Test”选项卡，同时用idQ指定它属于我们的共享命名空间：

<customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui" namespace="MyCompany.Excel.SharedAddins">
  <ribbon>
    <tabs>
      <!-- 定义共享的Test选项卡 -->
      <tab idQ="MyCompany.Excel.SharedAddins.TestTab" label="Test">
        <!-- 第一个Add-in的专属控件组 -->
        <group id="Addin1Group" label="Add-in 1 Tools">
          <button id="Addin1Button" label="Add-in 1 Action" size="large" onAction="Addin1Button_Click"/>
        </group>
      </tab>
    </tabs>
  </ribbon>
</customUI>

4. 后续Add-in关联同一个选项卡 #

在第二个、第三个Add-in的Ribbon XML里，不要重新创建选项卡，而是通过idQ引用已有的共享选项卡，直接添加自己的控件组即可：

<customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui" namespace="MyCompany.Excel.SharedAddins">
  <ribbon>
    <tabs>
      <!-- 引用共享的Test选项卡 -->
      <tab idQ="MyCompany.Excel.SharedAddins.TestTab">
        <!-- 第二个Add-in的专属控件组 -->
        <group id="Addin2Group" label="Add-in 2 Tools">
          <button id="Addin2Button" label="Add-in 2 Action" size="large" onAction="Addin2Button_Click"/>
        </group>
      </tab>
    </tabs>
  </ribbon>
</customUI>

Office会自动把这个控件组追加到已有的“Test”选项卡中，不会创建新的同名选项卡。

5. 处理代码逻辑 #

每个Add-in的Ribbon代码类（比如Ribbon1.cs）要确保正确实现IRibbonExtensibility接口的GetCustomUI方法，返回对应的Ribbon XML内容。同时，每个控件的点击事件（比如Addin1Button_Click）要在各自的代码文件里独立实现，互不影响。

常见注意事项 #

• 命名空间必须完全一致，包括大小写，Office对这个是严格匹配的。
• 不要混用可视化设计器和Ribbon XML，否则会破坏共享逻辑。
• 单个Add-in卸载后，对应的控件组会自动从“Test”选项卡中移除，剩余Add-in的控件依然保留。
• 确保所有Add-in的目标Office版本一致，避免兼容性问题。

内容的提问来源于stack exchange，提问作者T. Moser