VSCode快捷键定制必须手动编辑keybindings.json，通过追加含key、command、when字段的JSON对象实现精准控制，其中when条件决定触发上下文，跨平台需用isMac/isWindows区分。
直接说结论：VSCode 的快捷键定制不是“锦上添花”，而是你每天省下 10–20 分钟、避免打断思路的关键动作。它不依赖插件，也不需要写代码，但必须手动编辑 keybindings.json 才能真正按需控制。
怎么打开并安全修改 keybindings.json
别用图形界面点来点去——那个“键盘快捷方式”UI 只能做简单增删，冲突时不会报错，改完还可能被覆盖。真正可控的方式是直编 JSON 文件：
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Preferences: Open Keyboard Shortcuts (JSON)并回车 - 文件会以纯 JSON 格式打开，结构是数组，每项是一个对象，含
key、command、when三个核心字段 - 不要删除已有条目，只在数组末尾追加新规则；每次保存后 VSCode 自动热重载，无需重启
- 如果改崩了，删掉自己加的几行，或直接删掉整个
keybindings.json（它会在下次启动时重建默认配置）
when 条件表达式为什么总失效
很多自定义快捷键按了没反应，问题几乎都出在 when 上。它不是可选字段，而是决定“什么时候这个快捷键才生效”的开关：
-
"when": "editorTextFocus"：仅当光标在编辑器文本中时生效（比如你在终端或侧边栏聚焦时就不触发） -
"when": "editorHasSelection"：必须有文字被选中才可用，常用于批量操作类命令 -
"when": "resourceScheme == 'file'"：只对本地文件生效，排除 Settings UI、GitHub Pull Request 等网页视图 - 多个条件用
&&连接，比如"when": "editorTextFocus && editorLangId == 'python'"表示只在 Python 文件中生效 - 查当前上下文的
when值？按Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 控制台里执行vscode.workspace.getConfiguration().get('editor')不行；正确做法是打开命令面板，输入Developer: Inspect Context Keys，然后点击任意区域看实时when状态
常见冲突：为什么你设的 Ctrl+Shift+F 总被格式化抢走
VSCode 默认把 Ctrl+Shift+F 绑定给“全局搜索”，而很多人想把它改成“格式化文档”。这不是 bug，是设计逻辑：
- VSCode 优先响应范围更广的命令。全局搜索（
workbench.action.findInFiles）的when是true，而格式化（editor.action.formatDocument）默认要求editorTextFocus - 解决办法不是删掉原绑定，而是**覆盖它**：在
keybindings.json中明确写一条key相同、command不同、且when更精确的新规则 - 例如：想要
Ctrl+Shift+F在编辑器里格式化，在其他地方仍搜全局，就写两行——第一行限定editorTextFocus给格式化，第二行加!editorTextFocus保留原搜索 - 注意顺序：JSON 数组从上到下匹配，第一条满足条件的就执行，后面的忽略
跨平台快捷键适配的硬伤
Windows 和 macOS 的修饰键映射不同，但 VSCode 不自动转换 key 字段。这意味着你导出的 keybindings.json 到 Mac 上可能全失效：
-
Ctrl在 macOS 上对应Cmd，Alt对应Option，但 JSON 里写的还是"key": "ctrl+shift+f" - 官方方案是用平台判断语法：
"key": "cmd+shift+f"（macOS）、"key": "ctrl+shift+f"（Windows/Linux），但必须写成两条独立规则，靠when区分平台 - 更稳妥的做法是：在
when中加平台判断，如"when": "isMac && editorTextFocus"或"when": "isWindows && editorTextFocus" - 别信某些教程说“改系统设置就能统一”，VSCode 的
key解析层完全绕过系统级快捷键管理，它只认自己解析出来的键码
真正难的不是写几条 JSON，而是理解每个 when 条件背后的实际焦点状态、命令作用域和平台差异。很多人配完发现“有时好使有时不行”，问题往往藏在条件表达式里，而不是键位本身。
