vscode没有官方一键打印快捷键表功能,唯一可靠入口是ctrl+k ctrl+s(windows/linux)或cmd+k cmd+s(macos);应导出json而非截图,务必验证when条件是否生效。

VSCode 没有官方“一键打印快捷键映射表”的功能,所谓 PDF 速查表都是社区快照,版本滞后、缺少 when 条件上下文,直接打印容易踩坑。
Ctrl+K Ctrl+S 是唯一可靠入口
这是打开实时、完整、可搜索的快捷键设置页的唯一标准方式(Windows/Linux),macOS 对应 Cmd+K Cmd+S。它不是命令面板(Ctrl+Shift+P),后者只列命令,不展示绑定关系、冲突标记和生效条件。
- 误按
Ctrl+K后没立刻接Ctrl+S,会触发其他前缀命令(比如折叠),需按Esc清除状态再重试 - 页面右上角搜索框输入
ctrl+shift+f这类组合,能直接定位所有命中项,含“Source”列(Default/User/Extension)和灰色when条件文本 - 带
(keybinding is overridden)标记的条目,点右侧 ▶ 可展开对比原始默认绑定和你当前生效的规则
导出 JSON 比截图更实用
快捷键设置页右上角「⋮」菜单里选「Export Keybindings」,会生成一个带全部用户自定义项 + 注释的 keybindings.json 文件。这个文件比截图或 PDF 更易复用:可直接导入另一台机器、用 git 版本管理、或粘贴进 VS Code 的 Preferences: Open Keyboard Shortcuts (JSON) 里覆盖重载。
- 别手动复制 UI 表格——格式错乱、
when条件被截断、Mac 和 Windows 键名混写(如把cmd写成ctrl) - 导出的 JSON 里每条都含
"key"、"command"、"when"字段,是真实生效配置,不是视觉快照 - 如果只想打印高频项,建议先在设置页搜索关键词(如
format、comment、terminal),再导出筛选后的子集
打印前必须检查 when 条件是否生效
很多快捷键“按了没反应”,根本原因不是键没绑对,而是 when 条件不满足。例如 Ctrl+L(选中当前行)只在 editorTextFocus 时有效——焦点在终端、设置页、侧边栏时,它就是静音的。
- 打印前务必打开设置页,逐条确认灰色
when文本是否符合你常用场景(比如是否漏了!editorReadonly导致在只读文件里失效) - 跨平台同步时,
when里若用了isMac或isWindows,得手动加分支逻辑,否则 macOS 用户拿到 Windows 配置会部分失效 - 浏览器打印预览里重点检查换行:像
ctrl+shift+p这种长组合容易被截成两行,建议用等宽字体导出为 Markdown 再转 PDF
真正可靠的映射表不是一张纸,而是你验证过、带 when 条件、能导入复用的 keybindings.json 文件——打印只是副产品,别让它掩盖了条件判断这个最常被忽略的环节。











