最常见原因是多个快捷键绑定同一操作，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 里多了一个逗号。动手前先开开发者工具看日志，比反复改配置更快。