VSCode快捷键打造个人定制化开发环境-VSCode-PHP中文网

vscode快捷键定制必须手动编辑keybindings.json，通过追加含key、command、when字段的json对象实现精准控制，其中when条件决定触发上下文，跨平台需用ismac/iswindows区分。

vscode快捷键打造个人定制化开发环境

直接说结论：VSCode 的快捷键定制不是“锦上添花”，而是你每天省下 10–20 分钟、避免打断思路的关键动作。它不依赖插件，也不需要写代码，但必须手动编辑 keybindings.json 才能真正按需控制。

别用图形界面点来点去——那个“键盘快捷方式”UI 只能做简单增删，冲突时不会报错，改完还可能被覆盖。真正可控的方式是直编 JSON 文件：

按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Preferences: Open Keyboard Shortcuts (JSON) 并回车
文件会以纯 JSON 格式打开，结构是数组，每项是一个对象，含 key、command、when 三个核心字段
不要删除已有条目，只在数组末尾追加新规则；每次保存后 VSCode 自动热重载，无需重启
如果改崩了，删掉自己加的几行，或直接删掉整个 keybindings.json（它会在下次启动时重建默认配置）

很多自定义快捷键按了没反应，问题几乎都出在 when 上。它不是可选字段，而是决定“什么时候这个快捷键才生效”的开关：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

"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 状态

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 解析层完全绕过系统级快捷键管理，它只认自己解析出来的键码