如何为现有Visual Studio扩展菜单添加子菜单？

问题背景 #

通过VSIX项目创建并部署了一个包含按钮的Visual Studio扩展菜单（A），现需创建第二个VSIX包，为菜单A添加子菜单（B），保留原有按钮实现模块化效果，但不能合并为单个VSIX项目。安装第二个VSIX包后，它会覆盖第一个扩展，仅显示第二个扩展的内容，期望实现菜单A同时包含原有按钮和子菜单B的效果。

问题原因 #

1. 第二个VSIX的*.vsct文件重复定义了主菜单TopMenu，这会覆盖第一个扩展中同名同ID的菜单定义
2. 第二个项目错误地使用了冲突的配置逻辑，导致菜单注册时覆盖原有内容

解决方案 #

第二个VSIX无需重新定义主菜单TopMenu，只需引用第一个扩展中已定义的主菜单GUID和ID，将自身的组挂载到该主菜单上，再添加子菜单和按钮。以下是修改后的第二个项目*.vsct文件：

<?xml version="1.0" encoding="utf-8"?>
<CommandTable ...>

    <Extern href="stdidcmd.h" />
    <Extern href="vsshlids.h" />

    <Commands package="guidMyTestVSPackage2"> <!-- 使用当前项目独有的Package GUID -->

        <!-- 移除重复定义的TopMenu，直接复用第一个扩展的主菜单 -->
        <Menus>
            <Menu guid="guidMyTestPackageCmdSet2" id="testMenu" priority="0x100" type="Menu">
                <Parent guid="guidMyTestPackageCmdSet2" id="MyAppMenuGroup" />
                <Strings>
                    <ButtonText>MyTest 2023</ButtonText>
                </Strings>
            </Menu>
        </Menus>

        <Groups>
            <!-- 将当前组挂载到第一个扩展的TopMenu下 -->
            <Group guid="guidMyTestPackageCmdSet2" id="MyAppMenuGroup" priority="0x0000">
                <Parent guid="guidMyTestPackageCmdSet" id="TopMenu"/>
            </Group>
            <Group guid="guidMyTestPackageCmdSet2" id="testMenuGroup" priority="0x0000">
                <Parent guid="guidMyTestPackageCmdSet2" id="testMenu"/>
            </Group>
            <Group guid="guidMyTestPackageCmdSet2" id="MyTestMenuGroup" priority="0x0600">
                <Parent guid="guidMyTestPackageCmdSet2" id="testMenu" />
            </Group>
        </Groups>

        <Buttons>
            <Button guid="guidMyTestPackageCmdSet2" id="MyTestCommandId" priority="0x0100" type="Button">
                <Parent guid="guidMyTestPackageCmdSet2" id="MyTestMenuGroup" />
                <Strings>
                    <ButtonText>Add MyTest NuGet Package</ButtonText>
                </Strings>
            </Button>
        </Buttons>

    </Commands>

    <Symbols>
        <!-- 当前项目的Package GUID，确保与第一个项目不同 -->
        <GuidSymbol name="guidMyTestVSPackage2" value="{212cdc15-f054-46cf-8db5-a4e2a75c0d1f}" />

        <!-- 引用第一个扩展的命令集GUID，用于定位已存在的主菜单 -->
        <GuidSymbol name="guidMyTestPackageCmdSet" value="{2ca5942d-9e0f-48cb-9eb8-a979358ff308}">
            <IDSymbol name="TopMenu" value="0x1022" />
        </GuidSymbol>

        <!-- 当前项目的命令集GUID，保持唯一 -->
        <GuidSymbol name="guidMyTestPackageCmdSet2" value="{2ca5942d-9e0f-48cb-9eb8-a979358ff309}">
            <IDSymbol name="testMenu" value="0x1021" />
            <IDSymbol name="testMenuGroup" value="0x1026" />
            
            <IDSymbol name="MyAppMenuGroup" value="0x1023" />
            <IDSymbol name="MyTestMenuGroup" value="0x1020" />
            <IDSymbol name="MyTestCommandId" value="0x0100" />
        </GuidSymbol>

    </Symbols>

</CommandTable>

关键注意事项 #

• 确保第一个扩展的命令集GUID（guidMyTestPackageCmdSet）和主菜单ID（TopMenu）在第二个项目中完全一致，才能正确定位到已存在的主菜单
• 第二个项目的Package GUID必须保持唯一，避免与第一个项目冲突
• 必须移除第二个项目中对主菜单TopMenu的重复定义，防止覆盖第一个扩展的菜单配置

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