最常见原因是多个快捷键绑定同一操作，VSCode执行最后加载的；需检查keybindings.json重复项、禁用可疑扩展、确认when条件及macOS系统热键冲突。

快捷键为什么按了没反应

最常见的情况是多个快捷键绑定到同一个操作，VSCode 会执行最后加载的那个——这包括默认键位、扩展贡献的键位、用户自定义的 keybindings.json 条目。比如你给 editor.action.formatDocument 设了 Ctrl+Shift+I，但 Prettier 扩展也绑定了相同组合键，且加载顺序靠后，你的设置就无效。

• 打开命令面板（Ctrl+Shift+P），输入 Preferences: Open Keyboard Shortcuts (JSON) 直接编辑 keybindings.json，避免图形界面覆盖
• 检查是否有重复 key 字段值（注意大小写和修饰键写法："ctrl+shift+i" ≠ "Ctrl+Shift+I"）
• 禁用可疑扩展后重启 VSCode，确认是否是扩展劫持了快捷键

如何安全覆盖默认快捷键

VSCode 不允许直接“删除”内置快捷键，但可以通过更高优先级的空操作或新绑定实现覆盖。关键在 when 条件表达式和 key 的精确匹配。

• 想禁用默认的 Ctrl+P（快速打开），加一条：

  [
    {
      "key": "ctrl+p",
      "command": "-workbench.action.quickOpen",
      "when": "true"
    }
  ]

• 若只想在编辑器中生效，把 "when": "editorTextFocus"；在终端里禁用，则用 "when": "terminalFocus"
• 不要用 "command": "" 或省略 command，那会导致行为不可预测

扩展快捷键不生效的排查路径

很多扩展（如 GitLens、ESLint、Remote-SSH）会在启用后动态注册快捷键，但前提是满足其 when 条件，且未被其他规则拦截。

• 运行 Developer: Toggle Developer Tools，切换到 Console 标签页，输入 console.log(JSON.stringify(monaco.keybindings.KeybindingsRegistry.getCommandRules().filter(r => r.command === 'gitlens.showQuickPick'))) 查看 GitLens 是否注册了该命令
• 在命令面板中搜索目标命令名（如 gitlens.showQuickPick），如果搜不到，说明扩展根本没激活或注册失败
• 检查扩展的 package.json 中 contributes.keybindings 是否存在，以及对应命令是否在 contributes.commands 中声明

macOS 上 Cmd 和 Ctrl 键行为异常

macOS 用户常遇到 Cmd+Shift+K 被系统截获（比如截图），或 VSCode 把 Ctrl 当作 Cmd 处理。这不是 VSCode bug，而是 Electron 渲染层与 macOS 原生快捷键系统的交叠。

• 系统设置 → 键盘 → 快捷键 → 屏幕快照，关闭 Cmd+Shift+K 等冲突项
• 在 settings.json 中添加：

  "keyboard.dispatch": "keyCode"

  （改用底层按键码而非语义键名，可绕过部分系统拦截）
• 避免在 keybindings.json 中混用 cmd 和 ctrl：macOS 下 "cmd+k" 等效于 Windows 的 "ctrl+k"，但 "ctrl+k" 在 macOS 上实际触发的是 Control 键，通常无意义

真正卡住人的往往不是“怎么加快捷键”，而是“为什么它不执行”——条件判断没写对、扩展没加载、系统级热键抢占、甚至只是 JSON 里多了一个逗号。动手前先开开发者工具看日志，比反复改配置更快。