VSCode快捷键设置分图形界面和JSON两种方式：图形界面（Ctrl+K Ctrl+S）适合快速绑定常用命令并即时生效，但不支持when条件；JSON方式可精准控制触发场景，需正确填写key、command和when字段。

VSCode 的键盘快捷键设置就在你手指按下的下一秒——不需要安装插件、不用改系统设置，所有操作都在编辑器内部完成，且修改后**立即生效**。

用图形界面快速绑定命令（适合 80% 场景）

这是最直观、最安全的入门方式，尤其适合想改几个常用操作（比如保存、格式化、切换终端）的人。

  • 直接按 Ctrl+K Ctrl+S（Windows/Linux）或 Cmd+K Cmd+S（macOS），立刻打开快捷键面板
  • 在搜索框输入命令关键词，比如 format document、toggle terminal、save
  • 找到目标条目后，点击右侧的 加号图标（或右键 → “更改键绑定”），然后按下你想设的新组合键，如 Ctrl+Shift+I
  • 如果提示冲突，VSCode 会高亮显示被覆盖的原命令；你可以选择“替换”，但建议先确认它是否真不影响你日常操作

⚠️ 注意：图形界面无法设置 when 条件（比如“仅在编辑器聚焦时生效”），也不支持多命令串联。但它能实时验证按键是否被识别、是否触发成功，是调试快捷键的第一步。

编辑 keybindings.json 实现精准控制（推荐进阶用户）

当你需要限定触发场景、避免误触，或者给没默认快捷键的命令（比如 terminal.runActiveFile）加键时，必须用 JSON 方式。

  • 按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Preferences: Open Keyboard Shortcuts (JSON) 并回车
  • 文件打开后，在 [ ] 数组内添加对象，例如：
[
  {
    "key": "ctrl+alt+r",
    "command": "terminal.runActiveFile",
    "when": "editorTextFocus"
  }
]
  • key 中的修饰符写法固定：ctrl、shift、alt、cmd（macOS）或 win（Windows），全部小写，用 + 连接
  • command 名称必须准确——可在图形界面中悬停命令条目，看 tooltip 里显示的完整 ID，比如 editor.action.formatDocument
  • when 是可选但强烈建议加上，常见值有：editorTextFocus、terminalFocus、explorerViewletVisible，避免快捷键在错误上下文里乱触发

排查冲突和恢复默认（别让快捷键“失灵”）

快捷键没反应？大概率是冲突、条件不满足，或命令名拼错了。

  • 按 Ctrl+Shift+P 输入 Preferences: Show Keybindings with Key，再输入你设的组合键（如 ctrl+alt+r），就能看到所有绑定了它的命令，包括被禁用的
  • 想临时停用某条快捷键？在图形界面中右键对应项 → “禁用”
  • 改乱了？点击快捷键面板右上角的 ⋯ → “重置为默认值”，或直接删掉 keybindings.json 中对应那一行
  • 注意：系统级热键（如 macOS 的 Cmd+Space 唤起 Spotlight）VSCode 无法捕获，这类组合键设了也无效

同步与复用配置（换电脑不重配）

你的 keybindings.json 就是你在 VSCode 里的“肌肉记忆备份”。

  • 文件路径通常在：~/.config/Code/User/keybindings.json（Linux）、%APPDATA%\Code\User\keybindings.json（Windows）、~/Library/Application Support/Code/User/keybindings.json（macOS）
  • 复制整个内容，粘贴到新机器同名文件中即可复用；更稳妥的是开启 VSCode 内置的

    Settings Sync    （登录账号后自动同步）
  • 不要把自定义快捷键和插件快捷键混在一起管理——插件自带的键绑定也能在图形界面里统一筛选、禁用或重映射

真正麻烦的不是设置本身，而是没意识到 when 条件的存在。很多“快捷键点了没反应”的问题，其实只是因为当前焦点不在编辑器里，而你没加 "when": "editorTextFocus"。这点容易被跳过，但恰恰是让快捷键从“能用”变成“可靠”的关键一环。