VSCode快捷键设置分图形界面和JSON两种方式：图形界面（Ctrl+K Ctrl+S）适合快速绑定常用命令并即时生效，但不支持when条件；JSON方式可精准控制触发场景，需正确填写key、command和when字段。
用图形界面快速绑定命令（适合 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"。这点容易被跳过，但恰恰是让快捷键从“能用”变成“可靠”的关键一环。
