VSCode键盘映射需编辑keybindings.json文件：用Ctrl+K Ctrl+S（Win/Linux）或Cmd+K Cmd+S（macOS）打开并修改用户级JSON，确保键绑定顺序在默认项之后、when条件准确、command有效且跨平台修饰键适配。
VSCode 的键盘映射不靠“安装插件”或“改系统设置”，而是直接编辑 keybindings.json 文件——改对位置、避开冲突、注意作用域，才能真正生效。
怎么打开并编辑 keybindings.json
快捷键 Ctrl+K Ctrl+S（Windows/Linux）或 Cmd+K Cmd+S（macOS）打开快捷键面板，右上角点击“打开键盘快捷方式（JSON）”图标（带花括号 {} 的文件图标），就会打开用户级的 keybindings.json。别手动新建或改错路径，VSCode 会自动维护这个文件的位置和格式。
- 该文件是 JSON 数组，每项是一个键绑定对象，不是 JavaScript 对象，不能写注释（// 或 /* */ 会报错）
- 如果想覆盖默认绑定，必须确保新条目在数组中排在默认项之后（VSCode 默认绑定隐式加载在前，用户定义在后）
- 不要复制粘贴整个默认 keybindings 到这里——只加你真正要改的几行
如何写一条有效的自定义绑定
一个最小可用的绑定长这样：
[
{
"key": "ctrl+alt+f",
"command": "editor.action.formatDocument",
"when": "editorTextFocus && !editorReadonly"
}
]关键字段说明：
-
key：触发组合键，用+连接，大小写敏感（ctrl+F和ctrl+f等价，但Ctrl+F写法不推荐） -
command：目标命令 ID，可在快捷键面板里右键某条目 → “复制命令 ID”获取；常见如workbench.action.terminal.toggleTerminal、editor.action.addCommentLine -
when（可选但强烈建议）：限定生效上下文，比如只在编辑器聚焦且非只读时才触发格式化；漏写可能导致快捷键在不该出现的地方抢响应
为什么你改了却没反应？几个高频坑
最常见失效原因不是语法错，而是逻辑冲突或作用域误判：
- 多个绑定共用同一
key且when条件都满足 → VSCode 执行**最后匹配到的一条**，顺序很重要 - 用了
when但条件太窄，比如写了editorTextFocus却在终端面板按快捷键——它根本不会触发 - 把绑定写到了错误的 JSON 文件里：确认你编辑的是用户级
keybindings.json，而不是工作区级（.vscode/keybindings.json）或被其他扩展覆盖的配置 - 某些命令本身不支持键盘触发（比如部分调试操作），即使绑定成功也无响应；可在命令面板（
Ctrl+Shift+P）搜命令名，看是否可手动执行
macOS 用户特别注意修饰键差异
macOS 下 cmd 对应 Windows 的 ctrl，ctrl 反而常用于系统级快捷键（如 ctrl+space 切输入法）。如果你习惯用 cmd+shift+p 呼出命令面板，那自定义时就该写 "key": "cmd+shift+p"，而不是照搬 Windows 写法。
- macOS 上
alt键实际对应option，VSCode 识别为alt，但某些外接键盘可能需要额外映射 - 如果想让某个快捷键跨平台一致，建议优先用
ctrl+ 字母（如ctrl+k ctrl+c注释），因为ctrl在 macOS 上通常不被系统强占 - VSCode 内置的
workbench.action.terminal.toggleTerminal在 macOS 默认是ctrl+`，但很多 Mac 键盘需按cmd+`才能输入反引号，这时你就得显式绑定成"key": "cmd+`"
真正的难点不在写法，而在理清“当前焦点在哪”“哪些命令此刻可用”“谁在抢这个键”。多试几次 Ctrl+Shift+P → 输入命令名 → 看它有没有快捷键提示，比硬记文档更可靠。
