Ctrl+K Ctrl+S修改不持久,因GUI仅写入用户级keybindings.json且不支持when条件,易被插件升级、多设备同步或扩展同名命令覆盖;JSON语法错误(如缺逗号、拼错command ID、when字段缺失)会导致整条规则静默失效。

改完就生效,不用重启,但“生效”不等于“能用”——多数失效问题出在配置没进对地方、条件没匹配上,或被系统/插件悄悄截胡。
Ctrl+K Ctrl+S 改的快捷键为什么有时不持久?
图形界面改快捷键确实按完就响应,但它只写入 keybindings.json 的用户级配置,且不支持 when 条件。这类修改容易被以下情况覆盖:
- 插件升级后重置默认绑定(比如 GitLens、Prettier 更新后自动加回自己的快捷键)
- 多设备同步时,JSON 配置未启用,GUI 设置不同步
- 你改的是“默认绑定”,但实际触发的是扩展提供的同名命令(来源列显示 “Extension” 而非 “Default”)
临时调速可用,长期依赖请直接编辑 JSON 文件。
编辑 keybindings.json 后没反应?先盯住这三处
VSCode 不报语法错误,但只要错一处,整条规则就静默丢弃:
-
when字段缺失或写错:比如想限定只在编辑器里生效,却漏写"when": "editorTextFocus",那它可能在终端里意外触发,或在资源管理器里完全失灵 - 命令 ID 拼错:不是
saveFile,而是workbench.action.files.save;不是formatDocument,而是editor.action.formatDocument—— 最稳方式是右键 GUI 中对应命令 → “复制命令 ID” - JSON 格式非法:少逗号、多引号、数组没包在
[ ]里、用了中文标点,VSCode 都不提示,只当整份配置不存在
怎么确认 Ctrl+Shift+P 这类键真被 VSCode 收到了?
很多“没反应”其实是系统或输入法提前吞掉了按键:
- Windows:搜狗/QQ拼音默认把
Ctrl+Space、Ctrl+Shift+P当中英文切换热键,关掉输入法设置里的对应选项再试 - macOS:Spotlight 占用
Cmd+Space,VSCode 默认改用Cmd+Shift+Space触发补全;若你硬绑了Cmd+Space,它根本到不了 VSCode - Logitech Options、Raycast、Alfred 等工具也常劫持组合键,临时退出它们是最快验证方式
真要查 VSCode 是否收到,打开开发者工具(Ctrl+Shift+P → Developer: Toggle Developer Tools),切到 Console,按下目标键,看日志里有没有 KeybindingService#dispatch 记录。
禁用某个默认快捷键,别删,要用 - 前缀
想释放 Ctrl+K Ctrl+I 给别的命令用?不能删掉原绑定,也不能留空 "command": "" —— VSCode 直接忽略整条规则。正确写法是:
[{"key":"ctrl+k ctrl+i","command":"-editor.action.showHover"}]
注意:- 必须紧贴命令 ID,中间不能有空格;大小写、点号必须和原始命令 ID 完全一致;这条规则要放进 keybindings.json 的数组里,和其他自定义项并列。
真正麻烦的不是写错,而是 when 条件太窄又忘了它存在——比如绑了 "when": "editorTextFocus && editorLangId == 'typescript',结果在 JS 文件里按了没反应,还反复检查 command 名是否拼对。











