VSCode快捷键排查需严格按序操作：先调出命令面板输入Developer: Toggle Keybinding Troubleshooter并回车，立即按下目标组合键；面板中带▶的绿色条目为实际生效命令，灰色条目因when条件不满足未触发；配置keybindings.json须确保合法JSON数组格式、命令ID大小写准确、补全when条件，并重载窗口生效。
Developer: Toggle Keybinding Troubleshooter 怎么用才不白按
它不是“按了就出结果”的傻瓜工具，必须严格按顺序触发：先 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）→ 输入 Developer: Toggle Keybinding Troubleshooter → 回车 → **立刻再按你想查的组合键**（比如 Ctrl+Shift+B）。中间停顿超过 1 秒，VSCode 就认为你已退出诊断模式，面板不会捕获按键。
面板弹出后，重点看带 ▶ 的绿色条目——那是当前真正生效的命令；灰色条目只是“理论上能匹配”，但因 when 条件不满足（比如你在终端里按了只在编辑器生效的快捷键）而没跑起来。别急着删灰色项，它可能下一秒就顶上来。
常见误操作：
- 在命令面板里输错命令名，比如少个
Developer:前缀，直接搜Toggle Keybinding会找不到 - 按完 Troubleshooter 后去干别的事，再回来按目标键——此时诊断已关闭，面板显示的是历史缓存，不是实时结果
- 远程连接（如 Remote - SSH）后没重进 Troubleshooter，某些扩展的快捷键是动态注入的，本地查不到
keybindings.json 里写 -command.id 为什么没反应
写了 {"key":"f5","command":"-gitlens.showQuickFileHistory"} 却发现 F5 还是被劫持，大概率卡在这三处：
-
keybindings.json不是合法 JSON 数组：哪怕只加一条，也必须包在[ ]里，且末尾要有逗号（如果后面还有其他条目） -
command字段写错大小写或点号：比如gitlens.showquickfilehistory或gitLens.showQuickFileHistory都无效；最稳妥方式是右键快捷键列表里的对应项 → “复制命令 ID” - 漏了
when条件，导致这条禁用规则在错误上下文生效：例如你只想禁用编辑器里的冲突，但没加"when": "editorTextFocus"，那它可能在设置页或终端里也尝试执行，而那里根本没这个命令，整条就被静默丢弃
注意："command": "-xxx" 只是取消绑定，不会自动 fallback 到 VSCode 默认行为。禁用后 F5 就真没用了，得手动补一条新绑定，比如 {"key":"f5","command":"workbench.action.debug.start","when":"editorTextFocus"}。
为什么改完 keybindings.json 后快捷键还是不生效
VSCode 不校验 JSON 语法错误，但只要有一个引号没闭合、一个逗号多写了、或数组外层少了 [ ]，整份配置就静默失效——界面不报错，也不提示，就像什么都没改过。
正确做法是：通过命令面板运行 Preferences: Open Keyboard Shortcuts (JSON) 进入编辑，别手写路径或粘贴到错误文件里。改完保存后，执行 Developer: Reload Window 强制重载，尤其涉及远程窗口或焦点条件变更时。
另外两个常被忽略的干扰源：
- 中文输入法（如搜狗、QQ 拼音）在按下
Ctrl+Shift+P等组合键时，可能直接转成中英文切换，根本没把按键传给 VSCode；临时切到英文输入法再试一次，比调十次配置更快 - 非美式键盘用户，
settings.json中必须设"keyboard.dispatch": "keyCode"，否则Ctrl+;可能被识别为Ctrl+:，绑定永远不命中
同步快捷键到新设备后失效的真正原因
Settings Sync 默认不上传 keybindings.json，即使你开了同步，右下角云图标亮着，也大概率没传过去。验证方法：运行 Sync: Show Summary，展开 Keybindings 条目，看 “Last Sync” 时间是否更新；若显示 “Not synced”，说明它压根没参与同步。
跨平台同步更要小心：Cmd 和 Ctrl 不能硬套。同一份配置在 macOS 上用 Cmd+Shift+B，Windows 上却想让它走 Ctrl+Shift+B，必须靠 when 区分平台，或者写两条独立绑定：
[{"key":"ctrl+shift+b","command":"workbench.action.terminal.runSelectedText","when":"isWindows || isLinux"},{"key":"cmd+shift+b","command":"workbench.action.terminal.runSelectedText","when":"isMac"}]别指望“统一物理键位”，而是让逻辑行为一致。复杂点在于：不同平台的 when 条件变量（如 isMac）必须拼写准确，错一个字母整条就失效，且 VSCode 完全不提醒。
