VSCode 快捷键修改后立即生效，但图形界面设置易被插件或更新覆盖；稳定、可同步、带条件控制的配置必须编辑 keybindings.json 文件。
VSCode 的快捷键改完就生效，不用重启，但图形界面改的容易被插件或更新覆盖；真正稳定、可同步、带条件控制的设置，必须编辑 keybindings.json 文件。
用 Ctrl+K Ctrl+S 快速绑定常用命令（适合临时调整）
这是最快上手的方式，适合改几个高频操作，比如保存、格式化、切换终端。直接按 Ctrl+K Ctrl+S（macOS 是 Cmd+K Cmd+S）打开快捷键面板，在搜索框里输 save 或 format document，找到后点右侧键盘图标，按下新组合键即可。
- 冲突时 VSCode 会高亮原绑定，选“替换”前建议确认它是否真不影响你——比如把
Ctrl+P改掉，就丢掉了快速打开文件的能力 - 不支持
when条件，比如你没法设“只在编辑器里生效”，所有命令全局响应 - 改完立刻可用，但插件升级后可能重置，不适合长期依赖
编辑 keybindings.json 添加带条件的快捷键（推荐主力方式）
打开命令面板 Ctrl+Shift+P，输入 Preferences: Open Keyboard Shortcuts (JSON) 回车。VSCode 会自动创建或打开用户级配置文件，里面是 JSON 数组，每条规则至少含 key 和 command：
{ "key": "ctrl+shift+f", "command": "editor.action.formatDocument", "when": "editorTextFocus" }
-
key修饰键顺序固定：ctrl、shift、alt、meta（macOS 的cmd），大小写敏感，backspace不能写成Backspace -
command名必须准确，可在图形界面右键目标命令 → “复制命令 ID”获取，别凭印象写saveFile这种不存在的值 -
when不是可选字段，省略等于"when": "true"，但会带来意外触发（比如在终端里按了格式化键，结果弹出报错）
为什么快捷键没反应？重点查这三处
常见现象是按键按下后毫无反应，不是 VSCode 坏了，大概率是配置逻辑卡在某个环节：
- 系统级热键拦截：比如
Ctrl+Alt+T在 Linux 默认唤起终端，VSCode 根本收不到这个组合键 -
when条件不匹配：当前焦点不在编辑器，而你写了"when": "editorTextFocus"，那它就是不会触发 - 命令名拼错或已弃用：旧插件升级后可能改了
command名，比如从extension.xxxFormat变成xxx.format，图形界面里搜不到就说明它可能已失效
跨平台同步时要注意修饰键映射
VSCode 会自动把 ctrl 映射为 macOS 的 cmd，所以同一份 keybindings.json 在 Windows 和 macOS 上都能用。但如果你硬写 cmd+shift+f，在 Windows 就彻底失效。
- 想让某条快捷键只在特定系统生效，得用
when表达式，比如"when": "isMac && editorTextFocus" - 非美式键盘（如德语、日语）布局下，某些键位物理位置和键码不一致，VSCode 无法识别
ctrl+ä这类组合，得靠系统级工具重映射底层键码
真正麻烦的不是怎么加一条快捷键，而是当项目协作、多设备同步、插件频繁更新时，keybindings.json 里的 when 条件是否依然贴合当前上下文——它不像 CSS 那样写完就静态生效，而是一直在运行时动态求值。
