如何为VSCode扩展绑定包含“+”符号的全平台可用快捷键？

核心问题原因 #

你在扩展package.json中配置不生效的核心原因是：扩展贡献的快捷键绑定不支持将带方括号的扫描码直接写在key字段中，用户自定义keybindings.json支持的shift+[BracketRight]写法不适用于扩展声明式配置。

跨平台适配方案 #

VSCode扩展的contributes.keybindings字段支持按操作系统指定配置，同时可搭配scanCode字段适配不同键盘布局，具体配置如下：

标准美式布局适配（覆盖90%以上场景） #

直接在package.json中按不同系统声明对应键值即可：

{
  "contributes": {
    "keybindings": [
      // Windows平台主键区+
      {
        "command": "你的扩展命令ID",
        "key": "shift+oem_plus",
        "os": "win"
      },
      // Linux平台主键区+
      {
        "command": "你的扩展命令ID",
        "key": "shift+=",
        "os": "linux"
      },
      // Mac平台主键区+
      {
        "command": "你的扩展命令ID",
        "key": "shift+=",
        "os": "mac"
      },
      // 全平台通用小键盘+（可选添加）
      {
        "command": "你的扩展命令ID",
        "key": "numpad_add"
      }
    ]
  }
}

非美式布局兼容方案 #

如果需要适配+号不在=键位的特殊键盘布局，可以额外添加scanCode字段绑定物理键位，示例如下：

{
  "command": "你的扩展命令ID",
  "key": "shift+=",
  "scanCode": "Shift+BracketRight",
  "os": "linux"
}

该配置下，只要用户按下shift+物理右中括号键，无论系统键盘布局映射的字符是什么，都能触发对应命令。

验证方法 #

扩展安装完成后，打开VSCode快捷键面板（快捷键Ctrl+K Ctrl+S），搜索你的扩展命令ID，即可看到来源为Extension的快捷键绑定，确认配置生效。

注意事项 #

• os字段必须为小写的win/linux/mac，拼写错误会导致配置不生效
• 如果系统全局快捷键或其他扩展占用了相同键位，你的扩展绑定会被覆盖，可通过调整when条件提升优先级，或提示用户手动修改快捷键配置

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