唯一可靠解法是直接编辑keybindings.json:通过Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)执行“Preferences: Open Keyboard Shortcuts (JSON)”,在空数组[]中添加含key、command及可选when字段的合法JSON对象。

直接改 keybindings.json,别碰 GUI 界面里的“键盘快捷方式”页面——它只展示、不生效,改了也白改。
怎么打开真正起作用的配置文件
VSCode 的快捷键只在用户级 keybindings.json 里生效,GUI 页面(Ctrl+K Ctrl+S)只是个查看器。误点“添加快捷键”按钮生成的 JSON 片段,常因格式错或位置错而静默失效。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS) - 输入并执行
Preferences: Open Keyboard Shortcuts (JSON) - 文件默认是空数组
[],你加的所有规则必须作为对象写在方括号内,不能删掉中括号 - 路径固定:
%APPDATA%\Code\User\keybindings.json(Win)、~/Library/Application Support/Code/User/keybindings.json(macOS)、~/.config/Code/User/keybindings.json(Linux)
key 和 command 字段怎么写才不被忽略
VSCode 不报错,但会静默跳过非法值。常见“配了没反应”,八成是这两个字段写错了。
-
key必须全小写、无空格;修饰键顺序固定为ctrl→shift→alt→meta(macOS 用cmd,Windows/Linux 用win),例如"ctrl+shift+p"✅,"Ctrl+Shift+P"❌ -
command必须是完整命令 ID,不是中文名。可在 GUI 快捷键页悬停目标命令看 tooltip,比如editor.action.formatDocument,不是 “格式化文档” - 字母键默认小写;想触发大写需显式加
shift,如"ctrl+shift+u"绑的是 Ctrl+Shift+U,不是 Ctrl+U - 功能键写全称:
f1、escape、backspace,不能简写为esc或del
为什么快捷键点了没反应?重点查 when 条件
这是最隐蔽也最常见的失灵原因。when 不匹配,VSCode 就当这条规则不存在。它不是可选项,而是上下文开关。
- 常见条件如
editorTextFocus(仅编辑器有焦点时)、terminalFocus(终端聚焦时)、!editorReadonly(编辑器非只读) - 多个条件用
&&连接,不能用逗号或空格;!表示取反,||在when中基本不用,易出错 - 想确认某快捷键当前是否满足条件,可用命令面板执行
Developer: Inspect Key Bindings,点击按键后看右侧列出的所有匹配项和对应when值 - 扩展(如 Vim 插件)可能注册宽泛的
when条件,覆盖你的规则;排查时建议先禁用可疑扩展
如何避免冲突或覆盖失败
VSCode 按加载顺序决定优先级:用户自定义 > 工作区 > 默认内置。但“后写就一定赢”不成立——数组顺序只影响同级别覆盖,且冲突时 VSCode 不提示。
- 在 GUI 快捷键页搜索你要绑定的
command,看右侧是否已有其他key;若有,要么换组合键,要么显式禁用原绑定(加负号前缀,如-editor.action.commentLine) - 不要随意删除默认
Ctrl+K类 chord starter 绑定,否则Ctrl+K Ctrl+C这类内置两步操作会彻底失效,无法靠新增一条规则恢复 - 临时禁用某条绑定,比删再重试更快:在 GUI 页面点击该条目左侧的“眼睛”图标即可
- 某些命令(如
workbench.action.terminal.toggleTerminal)本身支持 chord,但你不能自己定义新 chord,只能复用已有的 starter 键
真正麻烦的从来不是加一条快捷键,而是当它不响时,你得知道去哪查、查什么、怎么验证——when 条件、command ID 的大小写与拼写、以及扩展对输入焦点的劫持,这三处最容易卡住人。











