直接通过命令面板打开 Preferences: Open Keyboard Shortcuts (JSON) 获取纯净用户快捷键配置;导入前须检查 when 条件匹配、扩展已安装、键名适配平台;优先使用设置页“Import Keybindings…”合并导入。

直接导出 keybindings.json 文件就能共享快捷键,但只复制文件内容往往不生效——问题通常出在 when 条件不匹配、扩展未安装、或跨平台键名写死。
怎么拿到干净的用户快捷键配置
别从设置 UI 右键“导出”(该功能已移除),也别手动去文件系统翻整个 User 目录。唯一可靠路径是命令面板:
- 按
Ctrl+Shift+P(macOS 为Cmd+Shift+P) - 输入并选择
Preferences: Open Keyboard Shortcuts (JSON) - 此时打开的就是纯用户自定义部分,格式必须是合法 JSON 数组,例如:
[{"key":"ctrl+alt+l","command":"editor.action.formatDocument","when":"editorTextFocus"}] - 如果看到空数组
[],说明当前无自定义快捷键
导入前必须检查的三件事
快捷键是否真能用,不取决于 key 和 command 是否存在,而取决于 when 能否满足、扩展是否就位、平台是否适配:
-
when字段依赖上下文:比如notebookEditorFocused需 Jupyter 扩展;gitlens:fileBlameActive需 GitLens 已启用 - 对应扩展必须已安装:如
editor.action.formatDocument在没有 Prettier 或 ESLint 的机器上按了也没反应 - 跨平台键名不能硬写:
ctrl+shift+f在 macOS 上不会触发,得改成cmd+shift+f;VSCode 不自动转换修饰符
别直接覆盖,优先用图形界面合并
把备份的 keybindings.json 直接扔进 User/ 目录覆盖,容易引发冲突或覆盖掉别人新增的快捷键。更稳妥的做法是:
- 在目标机器上打开快捷键设置页(
Ctrl+K Ctrl+S) - 右键空白处 → “Import Keybindings…” → 选你的 JSON 文件
- VSCode 会自动合并、去重,并高亮显示冲突项,让你逐条确认
- 若需批量导入多条,仍建议先在源机器上用图形界面导出,再在目标机上用同一方式导入,避免手写 JSON 格式错误
真正容易被忽略的是 when 字段的隐式依赖——它不像扩展列表那样显性可查,也不报错,只是让快捷键“静默失效”。哪怕 JSON 格式完全正确、键名也适配平台,只要上下文条件不成立,那个组合键就永远没反应。











