vscode快捷键修改必须编辑keybindings.json文件才能真正生效，gui仅支持简单增删；需通过ctrl+shift+p输入“preferences: open keyboard shortcuts (json)”打开，自定义项添加到数组中，注意when条件、插件抢占及系统拦截问题。
VSCode 的快捷键修改必须编辑 keybindings.json 文件才能真正生效，GUI 界面（Ctrl+K Ctrl+S）只适合简单增删，一涉及冲突覆盖、条件触发或插件干扰，就立刻失灵。
怎么打开正确的 keybindings.json 文件
别用“Open Settings (JSON)”——那是改 settings.json 的，和快捷键无关。必须通过命令面板：Ctrl+Shift+P（macOS 是 Cmd+Shift+P）→ 输入 Preferences: Open Keyboard Shortcuts (JSON) → 回车。VSCode 会自动创建空数组 []（如果文件不存在），你所有自定义项都得塞进这个方括号里。
常见错误：手动去文件系统找路径复制粘贴，容易选错位置或权限异常；或者误开成用户设置文件，改半天没反应。
为什么加了新快捷键却没反应
不是配置写错了，大概率是以下三类问题之一：
-
when条件不满足：比如写了"when": "editorTextFocus"，但你在资源管理器或终端里按，它就完全静默——VSCode 不报错，也不提示，直接忽略 - 被插件劫持：GitLens、Vim 扩展等自带大量绑定，且优先级高于用户配置；查占用最准的方式是打开
Ctrl+K Ctrl+S，搜你的快捷键组合，看来源列是 “Default”、“Extension” 还是 “User” - 系统或输入法拦截：搜狗拼音、Logitech Options、Raycast 常偷偷吞掉
Ctrl+Shift+P或Ctrl+;这类组合键；临时退出它们再试一次，比重配十次更有效
如何安全禁用默认快捷键而不留坑
别删默认项，也别留空 "command": ""——VSCode 会直接忽略整条规则。正确做法是用负号前缀 + "unset"：
[{"key": "ctrl+k ctrl+i", "command": "-editor.action.showHover"}]
这条的意思是：明确禁用 editor.action.showHover 命令的默认绑定，释放 Ctrl+K Ctrl+I 组合，后续可放心绑定新命令。命令 ID 可在 GUI 中右键某条快捷键 → “复制命令 ID” 获取。
注意：- 必须紧挨着命令名，不能有空格；也不能写成 "- editor.action..."，否则无效。
非美式键盘用户必调的隐藏设置
中文、德语、日语等键盘布局下，Ctrl+; 常被识别成 Ctrl+:，导致自定义失效。这不是 VSCode bug，而是默认按字符 dispatch 导致的映射错乱。
解决方法：打开 settings.json（不是 keybindings.json），添加：
"keyboard.dispatch": "keyCode"
这个设置让 VSCode 按物理按键位置而非输入字符判断，所有基于 ;、[、] 等符号的快捷键才能稳定生效。它必须写在用户设置里，不能放在快捷键配置中。
真正难的不是加一条快捷键，而是搞清当前生效的是哪一条——同一组合键可能被 Default、多个 Extension、User 同时注册，而 VSCode 只执行第一个 when 为 true 的。调试时切记先查占用，再看条件，最后才动配置。
