VS Code 的 keyboard shortcuts 必须通过编辑 keybindings.json 文件修改，该文件位于用户配置目录下，可用命令面板中“Preferences: Open Keyboard Shortcuts (JSON)”安全打开；文件为 JSON 数组，每项含 key、command、when 字段，支持 // 注释，后定义覆盖前定义，多键可绑定同一命令；推荐重映射如 ctrl+shift+backspace 删除整行、ctrl+; 选中下一匹配项、ctrl+shift+enter 插入空行；when 条件不可省略，用于限定生效上下文，如 editorTextFocus；跨平台同步时建议统一用 ctrl 组合键，VS Code 会自动映射为 macOS 的 cmd，需平台特异逻辑可用 isMac/isWindows/isLinux；非美式键盘布局问题需底层重映射解决。
如何修改 VS Code 的 keyboard shortcuts.json 文件
VS Code 的快捷键不是只能在图形界面里点来点去改的，真正灵活、可复用、能同步的配置必须直接编辑 keybindings.json。它默认位于用户配置目录下，Windows 是 %APPDATA%\Code\User\keybindings.json，macOS 是 ~/Library/Application Support/Code/User/keybindings.json，Linux 是 ~/.config/Code/User/keybindings.json。
直接打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入 Preferences: Open Keyboard Shortcuts (JSON) 回车即可——这是最稳妥的打开方式，避免路径错误或文件不存在时被创建为空。
- 该文件是纯 JSON 数组，每项是一个对象，含
key、command、when三个核心字段 - 不要手动添加注释（JSON 不支持），想留说明就用
//开头的行（VS Code 支持这种非标准但实用的写法） - 重复绑定同一
key时，后定义的会覆盖前一个；多个快捷键绑定同一命令是允许的
常用高价值键位重映射示例
默认键位有不少反直觉设计，比如 Ctrl+Shift+K（删除整行）和 Ctrl+D（选中下一个匹配项）容易误触，而真正高频的操作反而没一键直达。以下几组是经过多人验证、显著减少手指移动距离的改法：
[
{
"key": "ctrl+shift+backspace",
"command": "editor.action.deleteLines",
"when": "textInputFocus && !editorReadonly"
},
{
"key": "ctrl+;",
"command": "editor.action.addSelectionToNextFindMatch",
"when": "editorTextFocus && !editorReadonly"
},
{
"key": "ctrl+shift+enter",
"command": "editor.action.insertLineBefore",
"when": "editorTextFocus && !editorReadonly"
}
]
-
ctrl+shift+backspace比原ctrl+shift+k更难误按，且符合“删除”操作常与backspace关联的直觉 -
ctrl+;替代ctrl+d，避开右手小指频繁伸展到D键的疲劳 -
ctrl+shift+enter插入空行比原ctrl+enter更易触发（后者常被输入法拦截）
为什么 when 条件不能省略
不加 when 可能导致快捷键在不该生效的地方抢响应，比如把 ctrl+tab 绑定到 workbench.action.nextEditor 后，在搜索框里按它会切编辑器而不是切换候选词。
MarkItDown 托管 Markdown 生成器：可将文件转换为 Markdown。支持 PDF、Word (.docx)、Excel (.xlsx/.xls)、PowerPoint (.pptx)、HTML、CSV、JSON、XML、图片等。
常见 when 表达式有：
-
editorTextFocus：光标在编辑器文本区（非侧边栏、搜索框等） -
!inQuickOpen && !suggestWidgetVisible：排除快速打开面板和补全弹窗场景 -
editorTextFocus && editorLangId == 'python'：仅在 Python 文件中生效 -
resourceExtname == '.md'：只对 Markdown 文件启用
查可用条件关键词，可在命令面板运行 Developer: Inspect Context Keys，然后点击任意 UI 元素看当前上下文。
同步与跨平台兼容性注意事项
如果你用同一份 keybindings.json 同步到 Windows/macOS/Linux，注意键名差异：
- macOS 上
ctrl对应cmd，alt对应option；VS Code 自动做了映射，但显式写成cmd或ctrl会影响行为 - 推荐统一用
ctrl+ 字母组合，VS Code 在 macOS 会自动转为cmd，避免写死cmd+shift+p导致 Windows 下失效 - 若需平台特异逻辑，可用
isMac、isWindows、isLinux做条件判断，例如："when": "editorTextFocus && isMac"
最麻烦的其实是外接键盘或非美式键盘布局（比如 Dvorak、日语键盘），某些键位物理位置变了，但 VS Code 仍按按键扫描码识别。这时候得用 keyboard.dispatch 设置或第三方工具重映射底层输入，已超出 VS Code 配置范畴。
