Ctrl+K Ctrl+S（macOS为Cmd+K Cmd+S）是VSCode唯一安全快捷键管理入口，图形界面提供实时冲突提示、when条件验证与命令来源追踪，跳过它直接编辑keybindings.json易因大小写、修饰键顺序或漏写when导致静默失效。
Ctrl+K Ctrl+S 是唯一安全入口，别一上来就改 JSON
图形界面不是摆设，它是防错第一道关卡。按 Ctrl+K Ctrl+S（macOS 是 Cmd+K Cmd+S）打开快捷键面板后，所有操作都带实时校验：冲突会标黄、when 条件可见、命令来源清晰。新手跳过这步直接改 keybindings.json，常因大小写错（"Ctrl+Shift+F" ❌）、修饰键顺序错（必须是 ctrl→shift→alt→meta）、漏 when 而静默失效。
- 搜索框输关键词比翻列表快得多，比如输
format就能定位到editor.action.formatDocument - 标黄感叹号的条目代表多命令共享该键，点开看来源再决定要不要动
- 右键目标命令可直接“更改键绑定”或“清除键绑定”，后者会写入
{"key": "", "command": "-"}，比手动删更稳妥
keybindings.json 里改键，重点盯死这三个字段
真正生效的绑定只在 keybindings.json 里，GUI 只是展示层。按 Ctrl+Shift+P 输入 Preferences: Open Keyboard Shortcuts (JSON) 打开它，结构必须是 JSON 数组，初始为空 []，别删中括号。
-
key：必须小写、无空格、修饰键顺序固定，"ctrl+shift+f"✅，"Ctrl+Shift+F"❌；功能键写全称，"f1"、"escape"，不能简写为"esc" -
command：必须是完整命令 ID，不是中文名。悬停在 GUI 命令上看到的 tooltip 字符串才是真名，比如editor.action.formatDocument，不是formatDocument或saveFile -
when：不是可选字段，省略等于全局生效，但极易误触。想只在编辑器里触发？必须写"when": "editorTextFocus"；想只对 Python 文件生效？用"when": "editorTextFocus && resourceExtname == '.py'"
快捷键按了没反应？先查这三处，不是 VSCode 坏了
多数“失灵”不是配置错，而是逻辑卡在某个环节：
- 系统级热键拦截：比如
Ctrl+Alt+T在 Linux 默认唤起终端，VSCode 根本收不到这个组合键 -
when条件不匹配：当前焦点在终端面板，而你写了"when": "editorTextFocus"，那它就是不会触发 - 命令名拼错或已弃用：插件升级后可能改了
command名，比如从extension.xxxFormat变成xxx.format；GUI 里搜不到，说明它很可能已失效
覆盖默认键或禁用它，优先用 unset 而不是删掉
VSCode 按数组顺序匹配，后写的条目会覆盖前面同 key 的规则。想禁用某个默认快捷键（比如屏蔽 Ctrl+K Ctrl+I 的悬停提示），不要删掉原配置，而是加一条：
[{"key": "ctrl+k ctrl+i", "command": "unset"}]
这样既明确表达了意图，又避免因顺序变动导致意外恢复。另外，跨平台同步时注意修饰键映射——VSCode 会自动把 ctrl 映射为 macOS 的 cmd，所以同一份配置在 Windows 和 macOS 上都能用；硬写 "cmd+shift+f" 在 Windows 就彻底失效。
真正容易被忽略的是 when 表达式的运行时上下文：它依赖当前焦点元素、语言模式激活状态、文件只读性等实时变量，不是静态开关。按 Ctrl+Shift+P 运行 Developer: Inspect Context Keys，点哪看哪，才能确认你写的条件到底满不满足。
