如何在SSMS SQL查询编辑器扩展的右键菜单中添加命令按钮？

我正在开发Visual Studio/SSMS扩展，想要在SQL查询编辑器窗口的右键菜单中添加自定义命令按钮。一开始用IDM_VS_CTXT_CODEWIN作为父菜单ID，这个设置在新建的.txt文件编辑器中有效，但在.SQL文件的编辑器里完全没反应。

按照网上的建议，我启用了EnableVSIPLogging注册表项，在SQL编辑器窗口按下Ctrl+Shift+右键点击后得到以下信息：

Guid = {33F13AC3-80B4ECE-85BC-225435603A5E}
GuidiD 240
CmdlD = 80
Type = 0x00000400
Flags = 0x00000000
NameLoc = (null)

但我不知道怎么用这些信息找到正确的父菜单ID，当前我的.vsct文件片段如下：

<Group guid="guidColumnToCSVPackageCmdSet" id="MyEditorCtxGroup" priority="0x001">
    <Parent guid="guidSHLMainMenu" id=""/>
</Group>

解决步骤 #

1. 解析VSIPLogging输出信息

你拿到的这段日志里，关键信息是：

• Guid = {33F13AC3-80B4ECE-85BC-225435603A5E}：这是SQL查询编辑器右键菜单对应的命令集GUID（注意格式可能有笔误，正确GUID格式应为8-4-4-4-12，建议重新确认一次）
• GuidID 240：这是该命令集下的右键菜单组ID，也就是我们需要的父菜单ID

2. 修改.vsct文件

第一步：添加SQL编辑器右键菜单的符号定义

在.vsct的<Symbols>节点下，新增SQL编辑器右键菜单的GUID和ID定义：

<Symbols>
    <!-- 新增SQL编辑器右键菜单符号 -->
    <GuidSymbol name="guidSQLEditorContextMenu" value="{33F13AC3-80B4ECE-85BC-225435603A5E}" />
    <IDSymbol name="IDM_SQL_CTXT_EDITOR" value="240" />

    <!-- 你的原有命令集符号 -->
    <GuidSymbol name="guidColumnToCSVPackageCmdSet" value="你的扩展命令集GUID" />
    <IDSymbol name="MyEditorCtxGroup" value="0x1020" />
</Symbols>

第二步：修改Group的父节点

把你的自定义Group的Parent指向刚才定义的SQL编辑器右键菜单：

<Group guid="guidColumnToCSVPackageCmdSet" id="MyEditorCtxGroup" priority="0x001">
    <Parent guid="guidSQLEditorContextMenu" id="IDM_SQL_CTXT_EDITOR"/>
</Group>

第三步：关联自定义命令到该Group

确保你的自定义Command节点的Parent是这个Group：

<Command guid="guidColumnToCSVPackageCmdSet" id="MyCommandId" priority="0x001" type="Button">
    <Parent guid="guidColumnToCSVPackageCmdSet" id="MyEditorCtxGroup"/>
    <Strings>
        <ButtonText>导出列到CSV</ButtonText>
    </Strings>
</Command>

3. 注意事项

• 检查GUID格式：如果右键菜单仍不显示，先确认你拿到的GUID格式正确（应为{XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}），可以重新用Ctrl+Shift+右键点击获取一次
• 重启宿主程序：修改.vsct后必须重启SSMS/Visual Studio，确保扩展重新加载
• SSMS兼容性：如果是SSMS扩展，要确保你的VSIX项目是针对对应SSMS版本创建的，部分SSMS版本对扩展的要求和Visual Studio略有差异

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