developer: toggle keybinding troubleshooter是vscode内置实时诊断工具，用于精准定位快捷键冲突：先按ctrl+shift+p输入该命令回车，再立即按下待查组合键，面板即列出所有匹配项，含来源扩展、command id及是否被覆盖状态。

Developer: Toggle Keybinding Troubleshooter 怎么用

这个命令是 VSCode 内置的实时诊断工具，专治“按了没反应”或“按了干了别的事”。它不依赖你猜、不翻设置、不查文档，直接告诉你当前按键到底被谁截了。

操作步骤很简单：

• 先按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）打开命令面板
• 输入 Developer: Toggle Keybinding Troubleshooter 并回车
• 立刻再按你想查的组合键（比如 Ctrl+Shift+P 本身）

弹出的面板会列出所有匹配项，包括：

• 来源扩展名（如 GitLens、Remote - SSH）
• 绑定的 command ID（如 workbench.action.showCommands）
• 是否显示为 overridden（说明被更高优先级规则覆盖）

注意：这个工具能捕获远程连接后动态注入的快捷键，图形界面查不到的它也能抓到。

keybindings.json 里怎么写才不被忽略

很多自定义快捷键写了却没反应，并不是语法错，而是结构或条件写得不对。VSCode 对 JSON 格式和字段语义很严格。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

关键点：

• keybindings.json 必须是合法 JSON 数组，哪怕只加一条，也要包在 [ ] 里，末尾不能少逗号
• key 字段必须全小写，修饰键顺序固定为 ctrl shift alt cmd（macOS 用 cmd，Windows/Linux 用 ctrl）
• when 字段一旦写错（比如拼成 editorFocus 而非 editorTextFocus），整条规则会被静默丢弃，VSCode 不报错也不提示
• 禁用某命令绑定要用 "command": "-some.command.id"，不是留空、不是 null，否则无效

示例（安全删除 GitLens 对 Ctrl+D 的劫持）：

[{"key":"ctrl+d","command":"-editor.action.addSelectionToNextFindMatch"}]

为什么改完 keybindings.json 还没生效

常见原因不是配置错了，而是环境或作用域没对上。

• 系统级程序抢键：搜狗拼音、Logitech Options、Raycast、甚至 macOS 的 Spotlight 都可能吞掉 Cmd+Shift+P ——临时退出它们再试一次，比改十次配置更有效
• when 条件不满足：比如写了 "when": "editorTextFocus"，但你是在终端面板里按的，自然没反应；鼠标焦点不在编辑器区域，就是白配
• 键盘布局干扰：中文/德语等非美键盘下，Ctrl+; 可能被识别成 Ctrl+:，根源是 VSCode 默认按字符 dispatch；必须在 settings.json 里设 "keyboard.dispatch": "keyCode"
• Remote - SSH 场景下，快捷键由远程端加载，本地 keybindings.json 不起作用，得在远程窗口里单独排查

图形界面 Ctrl+K Ctrl+S 和 JSON 编辑的区别

很多人跳过图形界面直接硬改 JSON，结果踩坑不断。其实两者分工明确：

• Ctrl+K Ctrl+S 是唯一安全入口：能实时看到冲突标黄、生效条件（when）、命令来源（内置 / 扩展 / 用户），还能右键“清除键绑定”，生成带 - 前缀的 JSON，比手写可靠得多
• 图形界面里点「更改键绑定」时，VSCode 会自动校验修饰键顺序和大小写，避免手输 CTRL+SHIFT+P 或 Ctrl+Shift+p 这类无效写法
• JSON 文件适合批量管理、版本控制、跨设备同步，但新增条目建议放在数组末尾——VSCode 按顺序匹配，后写的覆盖前面的同 key 绑定

真正容易被忽略的是：图形界面改完不用重启，但某些扩展（如 Remote - SSH）需要 Ctrl+Shift+P → Developer: Reload Window 才能刷新其动态注入的快捷键。