vscode命令面板只匹配注册的命令id或显示名，非自然语言；搜不到需用ctrl+k ctrl+s查id后复制粘贴；状态栏语言标识、光标位置、when条件、输入法、keyboard.dispatch设置及keybindings.json语法错误均影响命令生效。
搜不到命令，大概率是关键词没对上
VSCode 命令面板不理解“重命名”“格式化”“代码补全”这种自然语言，它只匹配注册的命令 ID 或显示名。比如想绑定重命名功能，输 rename 可能命中，但更稳的是搜 Refactor: Rename 或 Peek: Rename Symbol；想触发补全，必须搜 editor.action.triggerSuggest，而不是“提示”“建议”“自动完成”。
不确定命令名？先用 Ctrl+K Ctrl+S 打开快捷键设置页，顶部搜索框直接输功能关键词（如 formatSelection），命中后右键 → “Copy Command ID”，粘贴到命令面板里搜，100% 可见。
- 命令名大小写不敏感，支持空格分隔，但不支持连写（
formatdocument不会匹配Format Document） - 状态栏右下角语言标识必须就绪（如显示
JavaScript，不是Plain Text），否则Refactor: Rename这类语义命令压根不注册 - 光标得停在可操作符号上（比如变量名、函数名），否则即使搜到了，点击也灰掉不可用
命令搜到了却不能绑，检查 when 条件是否满足
很多命令右侧不显示快捷键，或你绑了但按了没反应，问题常出在 when 表达式上。比如 editor.action.formatDocument 的生效条件是 editorTextFocus && !editorReadonly —— 意思是：焦点必须在编辑器文本区，且文件不能是只读状态。你在终端里按，或者当前打开的是 output 面板，它就直接失效，面板里会显示灰色禁用图标。
- 按
Ctrl+Shift+P输入Developer: Toggle Keybinding Troubleshooter，然后立刻按你想查的组合键（如Ctrl+Space），绿色带 ▶ 的才是当前真正生效的条目 - 灰色条目说明
when不满足，比如terminalFocus但你其实在编辑器里 - Remote-SSH 环境下的快捷键，本地 Troubleshooter 查不到，必须在远程窗口里重跑一次
改了 keybindings.json 没生效，三个静默失败点
手动编辑 keybindings.json 是最灵活的方式，但也最容易白忙活。VSCode 遇到语法错误或逻辑矛盾时不会报错，只会跳过整条规则。
-
when表达式拼错（比如把editorTextFocus写成editorTextFocu），整条失效，且无日志提示 - 输入法劫持：中文输入法下
Ctrl+/常被转成中英文切换，务必切英文输入法再试 -
keyboard.dispatch设置错：Dvorak/Colemak 用户需在settings.json中加"keyboard.dispatch": "keyCode"，否则按键按物理位置而非字符逻辑
禁用某个扩展的快捷键，别点垃圾桶
图形界面点垃圾桶图标会删掉整个命令的所有绑定，容易误伤。精准释放某一条，必须手写 keybindings.json：
先右键快捷键列表中目标项 → “Copy Command ID”，得到类似 gitlens.showQuickFileHistory 的完整字符串；然后在 keybindings.json 末尾加：
[{"key":"ctrl+shift+b","command":"-gitlens.showQuickFileHistory"}]
注意：command 值前面必须加减号 -，不能写 "" 或 null，否则 VSCode 直接忽略整条。
真正容易被忽略的是：禁用之后，那个快捷键就真没用了，你得自己补一条新绑定，否则等于废掉。而且这条规则只取消绑定，不会让快捷键变灰或报错，表面看一切正常，实则已失效。
