快捷键“按了没反应”通常因系统或输入法劫持，需先切英文输入法并检查系统快捷键冲突；再通过命令面板查重叠绑定、禁用干扰扩展；最后验证keybindings.json格式正确性及when条件。
快捷键“按了没反应”？先确认是不是被系统或输入法劫持了
很多情况下，Ctrl+Shift+P、Cmd+Option+↑ 或 Ctrl+Tab 按下后毫无反应，并不是 VSCode 坏了，而是操作系统或输入法抢先截获了这个组合。比如：
-
macOS 中
Cmd+Option+←/→默认切换桌面，会直接屏蔽 VSCode 的“跳转到上一个编辑器组”功能 - Windows 上微信/QQ 的截图热键常占用
Ctrl+Alt+A，而它恰好和某些扩展的命令冲突 - 中文输入法激活状态下，
Ctrl+;或Ctrl+'很可能根本不会触发任何命令——VSCode 只在英文输入法下可靠识别这些键位
验证方法很简单：切到英文输入法，再试一次；或者打开系统设置 → 键盘 → 快捷键，逐项检查是否有重叠。别急着改 VSCode 配置，先清掉“拦路虎”。
快捷键明明还在列表里，却不起作用？查冲突和覆盖关系
打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并执行 Preferences: Open Keyboard Shortcuts (JSON)，然后在搜索框里直接粘贴你怀疑失效的快捷键，比如 Ctrl+S。VSCode 会高亮所有绑定到它的命令——如果出现多个，就说明冲突已发生。
- 常见干扰源：Vim 扩展会让
Esc进入普通模式，导致Ctrl+C在非插入模式下完全失灵 - Emacs 键绑扩展、GitLens、Bracket Pair Colorizer 等都可能悄悄注册同名快捷键
- 更隐蔽的是：你可能曾右键点了某个快捷键，误按了
Delete键，结果把整个绑定清空了（界面不提示，但命令确实没了）
解决方式不是硬记哪个插件干的，而是用“过滤+禁用”快速定位：在图形化快捷键界面右上角点齿轮图标 → “在扩展中查找”，输入扩展名，看它绑了哪些键；或直接在 keybindings.json 中加一行 {"key": "ctrl+alt+t", "command": "-extension.taskRunner"} 来禁用特定扩展的快捷键。
Help: Keyboard Shortcuts Reference 打不开？别只盯着菜单栏
这个 PDF 参考手册打不开，90% 是因为快捷键本身被覆盖或命令链路中断，而不是 PDF 文件丢了。优先走命令面板直连路径：
- 按
Ctrl+Shift+P→ 输入Help: Keyboard Shortcuts Reference→ 回车 - 如果失败，终端执行
code --disable-extensions启动无扩展模式，再试一次。能打开就说明是某扩展在捣鬼 - 仍不行？去配置目录手动找 PDF：
~/.vscode/extensions/.../keyboard-shortcuts.pdf（Linux/macOS）或%USERPROFILE%\AppData\Local\Programs\Microsoft VS Code\resources\app\out\vs\workbench\contrib\help\browser\keyboard-shortcuts.pdf（Windows）
注意：不要试图用文件管理器双击打开这个 PDF——它依赖 VSCode 内部资源路径，必须由 VSCode 自己加载才显示完整样式和交互链接。
重置键绑定后还是无效？检查 keybindings.json 是否损坏
自定义快捷键写进 keybindings.json 后，哪怕只多了一个逗号、少了一个引号，整个文件都会解析失败，VSCode 会静默忽略全部自定义规则，退回到默认状态——但你可能误以为“重置成功了”。打开 Preferences: Open User Keybindings (JSON)，检查内容是否符合合法 JSON 数组格式：
[{"key": "ctrl+shift+f", "command": "actions.find"}]
常见错误包括：
- 末尾多逗号：
... "command": "actions.find"}, - 用了注释：
// 这行会导致整个文件失效 - 根节点不是数组，而是对象：
{...}（必须是[...]） - 路径权限问题：Windows 下若该文件被设为“只读”，VSCode 保存时不会报错，但实际没写入
最稳妥做法：全选内容 → 删除 → 只留 [] → 保存 → 重启 VSCode。再一条条加回你需要的快捷键，每加一条就测试一次，避免批量引入错误。
真正麻烦的不是快捷键设不上去，而是它“看起来设上了，却在某个特定场景下失效”——比如 Ctrl+D 在编辑器里好使，在搜索框里却选不了下一个匹配项。这时候得看 when 条件：VSCode 不只认按键，还严格判断当前焦点、编辑器状态、是否启用 GitLens 等上下文。漏掉这个维度，修复就是盲人摸象。
