VSCode格式化快捷键失效90%非软件损坏，而是被系统/输入法、插件或配置冲突劫持；应依次排查按键是否送达、语言模式是否正确、格式化扩展是否启用及keybindings.json是否误禁用。
VSCode格式化快捷键（如Shift+Alt+F）没反应、灰色不可用、或执行了错误的格式化器——90% 是被其他插件、系统热键或配置层级冲突劫持了，不是 VS Code 坏了。
怎么立刻知道谁抢走了 Shift+Alt+F
别猜，直接打开 VS Code 的「按键排查镜」：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Developer: Toggle Keybinding Troubleshooter 并回车，然后立刻按下 Shift+Alt+F（或你失效的组合键）。面板会弹出，明确列出所有匹配该按键的绑定项，包括来源扩展、命令 ID、是否被覆盖。
常见抢键选手：GitLens、Prettier、Vim、ESLint 插件，以及系统级输入法（如搜狗拼音把 Shift+Alt 当中英文切换键）。
- 看到多条结果且来源不同 → 真实冲突
- 只有一条但状态为灰色 → 可能是
when条件不满足（比如当前没聚焦编辑器） - 面板里没任何记录 → 键根本没传到 VS Code，大概率被系统/输入法/硬件拦截
为什么右下角语言模式正确，Shift+Alt+F 还是灰色
灰色 = VS Code 认为“当前上下文不支持格式化”，核心原因只有两个：language mode 没配对，或该语言没声明默认格式化器。
检查步骤：
- 点击编辑器右下角语言标识（如
JavaScript），确认不是Plain Text或拼写错误（typescriptreact≠typescript） - 打开
settings.json，搜索editor.defaultFormatter，确保有对应语言块，例如：[javascript]: { "editor.defaultFormatter": "esbenp.prettier-vscode" } - 确认该格式化器扩展已安装且启用；如果用了 ESLint，必须关掉它的格式能力：
"eslint.format.enable": false - 删掉可能存在的负向覆盖：
"[javascript]": { "editor.formatOnSave": false }这类设置会让格式化直接禁用
改完 keybindings.json 为什么 Shift+Alt+F 还是没变
手动改 JSON 容易踩三个隐性坑，导致配置静默失效：
-
keybindings.json必须是合法 JSON 数组，哪怕只加一条，也得包在[ ]里，每条末尾带逗号（最后一项除外） -
when条件写太窄，比如"when": "editorTextFocus"，你在设置页按快捷键就完全不触发 -
keyboard.dispatch设置不当：中文键盘用户常需在settings.json加一行"keyboard.dispatch": "keyCode"，否则Ctrl+;可能被识别成Ctrl+:
安全写法示例（仅在编辑器聚焦且非只读时生效）：
[{"key":"shift+alt+f","command":"editor.action.formatDocument","when":"editorTextFocus && !editorReadonly"}]
如何禁用 GitLens 的 Ctrl+Shift+H 而不卸载它
不想扔功能，只想释放快捷键？用 VS Code 官方支持的负号语法最干净：
- 在快捷键界面（
Ctrl+K Ctrl+S）搜索Ctrl+Shift+H，找到 GitLens 对应项 - 右键 → “复制命令 ID”，得到类似
gitlens.showQuickFileHistory - 在
keybindings.json中加一条：[{"key":"ctrl+shift+h","command":"-gitlens.showQuickFileHistory"}] - 注意：
-必须紧贴命令名前，不能有空格；命令 ID 必须写全，不能简写
禁用后快捷键不会变灰，只是不再触发——如果你还想用这个键做别的事，得紧接着补上新绑定，否则等于留空。
真正难的不是改配置，而是意识到：VS Code 的快捷键行为由四层叠加决定——系统/输入法 → VS Code 主进程 → 插件注册 → 用户 keybindings.json。漏查任意一层，问题就会复现。
