VSCode不支持自定义两步组合快捷键,仅内置chord机制(如Ctrl+K Ctrl+C)可用;需用when条件配对命令或借助multi-command等扩展实现多步操作。

VSCode 里没法直接“绑定两步组合快捷键”
VSCode 的 keybindings.json 不支持原生录制或定义“先按 Ctrl+K,再按 C”这类分步触发的快捷键。它只认单次按键事件(含修饰键),所谓“Ctrl+K Ctrl+C”其实是两个独立按键动作:第一个是 Ctrl+K(触发一个“等待下一个键”的内部状态),第二个是 C(在该状态下执行对应命令)。这不是用户可自定义的“两步组合”,而是 VSCode 内置的 chord(和弦键)机制。
想复现 Ctrl+K Ctrl+C 这类 chord 快捷键,得用 when 条件 + command 配对
VSCode 允许你定义 chord,但必须满足两个前提:一是第一个键必须是已注册为 chord starter 的命令(比如 editor.action.commentLine 对应的默认 Ctrl+K Ctrl+C),二是你要在 keybindings.json 中显式写出两个键,并用 when 约束第二步的触发上下文。
- 不能随便写
"key": "ctrl+k ctrl+c"就生效——必须确保第一个键(ctrl+k)已绑定到一个带chord行为的命令 - 常见 chord starter 命令有:
workbench.action.terminal.toggleTerminal、editor.action.commentLine、editor.action.formatDocument,它们的默认 keybinding 都启用了 chord 支持 - 如果你删掉了默认的
Ctrl+K绑定,那后续Ctrl+K Ctrl+C就完全失效,无法靠加一条新规则恢复 - 自定义 chord 示例(给 Markdown 文件加专属注释):
[ { "key": "ctrl+k", "command": "editor.action.commentLine", "when": "editorTextFocus && editorLangId == 'markdown'" }, { "key": "ctrl+c", "command": "editor.action.commentLine", "when": "editorTextFocus && editorLangId == 'markdown' && chord" } ]注意第二条的when必须含chord,否则它会被当作普通快捷键拦截
真正想“绑定任意两步操作”,得绕过 chord,用扩展或脚本
比如你想实现“按 Alt+1 后,再按 Enter 插入时间戳”,VSCode 原生做不到。这时候只有两个靠谱路径:
- 装扩展:
multi-command(推荐)或command-runner,它们允许你定义一个命令序列,然后给这个序列绑单快捷键(如Alt+Shift+T直接插入时间戳+换行) - 用
macros扩展(已停更但可用)或run-on-save类扩展间接模拟,但稳定性差、调试难 - 别碰
keybindings.json里硬写ctrl+k ctrl+c想覆盖默认行为——容易导致 chord 失效或冲突,尤其在更新 VSCode 后 - 注意:所有扩展方案都依赖编辑器焦点在编辑器内;如果焦点在搜索框、终端或侧边栏,宏/多命令不会触发
为什么改了 keybindings.json 还不生效?检查这三点
chord 类快捷键最容易卡在这几个隐形环节:
- 你的
when条件太窄,比如写了editorTextFocus && resourceExtname == '.js',但当前文件是.ts,那就静默失败 - 快捷键被其他扩展劫持——打开命令面板(
Ctrl+Shift+P),输入Preferences: Open Keyboard Shortcuts (JSON),右上角点“显示与之冲突的快捷键”,看有没有红字提示 - VSCode 启动时没重载 keybinding:改完
keybindings.json后,要么重启窗口(Developer: Reload Window),要么手动触发一次“应用更改”(保存后弹出的小提示点“是”)
chord 的本质是状态机,不是字符串匹配。它依赖 VSCode 内部对“第一个键是否开启 chord 模式”的判断,而这个判断只对少数内置命令开放。想绕开它做任意两步,就得接受扩展介入的复杂度——这点没法简化。


















