VSCode扩展中如何在Help菜单下添加新子菜单？

排查修复步骤 #

• 注册对应命令：你配置里的first-kit.helpdesk和first-kit.documentation必须在package.json的commands数组中声明，VSCode会自动隐藏无对应命令的菜单项。示例配置：

  "commands": [
    {
      "command": "first-kit.helpdesk",
      "title": "Helpdesk"
    },
    {
      "command": "first-kit.documentation",
      "title": "Documentation"
    }
  ]
  

• 修正group分组格式：Help菜单的分组命名需遵循VSCode规范，不能使用无前缀的自定义分组名。建议改为z_firstKit（确保菜单排在末尾）或内置分组navigation，修改后：

  "menus": {
    "help": [
      {
        "submenu": "firstkitSubmenu",
        "group": "z_firstKit"
      }
    ]
  }
  

• 重新加载扩展：修改package.json后，执行Ctrl+Shift+P > Reload Window，确保新配置生效。
• 检查ID一致性：确认submenus中的id与menus里引用的完全一致（VSCode的ID区分大小写）。

替代方案：直接添加菜单项或使用其他顶部菜单 #

如果Help菜单子菜单仍无法显示，可选择以下方式：

• 直接在Help菜单加菜单项：跳过子菜单，直接将命令挂载到Help菜单：

  "menus": {
    "help": [
      {
        "command": "first-kit.helpdesk",
        "group": "z_firstKit"
      },
      {
        "command": "first-kit.documentation",
        "group": "z_firstKit"
      }
    ]
  }
  

• 在其他顶部菜单添加子菜单：比如在View菜单下添加子菜单，只需将menus中的help改为view即可，配置逻辑与Help菜单一致：

  "menus": {
    "view": [
      {
        "submenu": "firstkitSubmenu",
        "group": "z_firstKit"
      }
    ],
    "firstkitSubmenu": [
      {
        "id": "helpdesk",
        "command": "first-kit.helpdesk",
        "title": "Helpdesk"
      },
      {
        "id": "documentation",
        "command": "first-kit.documentation",
        "title": "Documentation"
      }
    ]
  }
  

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