VSCode格式化快捷键失效主因是keybindings.json文件损坏、含非法注释或存在"-editor.action.formatDocument"禁用项；需检查JSON合法性、删除减号命令、确认语言模式与defaultFormatter配置匹配。
VSCode格式化快捷键突然失效，大概率不是插件崩了，而是 keybindings.json 文件被破坏、被覆盖，或某条带减号的禁用规则悄悄生效了——它不报错，但会直接让 editor.action.formatDocument 命令“静音”。
快捷键面板里搜不到 formatDocument？先查 keybindings.json 是否合法
VSCode 一旦发现 keybindings.json 有语法错误（比如多逗号、注释、引号不闭合），就会整份忽略，降级回用内置默认绑定。此时你搜 formatDocument，列表可能为空或只剩灰色条目。
- 按
Ctrl+K Ctrl+S（Win）打开快捷键面板 → 点右上角「打开键盘快捷方式（JSON）」 - 检查文件是否为标准 JSON 数组：开头是
[，结尾是]，每条规则用逗号分隔，末尾不能有多余逗号 - 删掉所有
//或/* */注释（JSON 不支持） - 若文件只剩
[]或完全空白，去%APPDATA%\Code\User\（Win）或~/Library/Application Support/Code/User/（macOS）找keybindings.json.bak恢复
快捷键能搜到但按了没反应？检查有没有带减号的禁用项
keybindings.json 中以 "-" 开头的命令会主动取消绑定，且 VS Code 不提示、不警告。常见于更新后插件自动写入，或手动调试时加的临时屏蔽。
- 在快捷键 JSON 文件中搜索
"-editor.action.formatDocument" - 找到类似这样的条目：
{"key":"shift+alt+f","command":"-editor.action.formatDocument"} - 直接删掉整条，或把
-editor.action.formatDocument改成editor.action.formatDocument - 别只改 command 名字——必须确保该 key 组合没有被其他扩展重复注册（可用
Developer: Toggle Keybinding Troubleshooter验证）
Shift+Alt+F 仍灰色？语言模式和 defaultFormatter 必须同时对齐
快捷键亮起的前提是：VS Code 认出当前文件语言，且该语言配置了可用的格式化器。两者缺一不可，且配置层级优先级高于快捷键本身。
- 点击右下角语言标识，确认不是
Plain Text；.vue文件要选Vue，不是HTML；.ts要选TypeScript，不是JavaScript - 打开
settings.json，检查是否有语言块配置，例如："[typescript]": { "editor.defaultFormatter": "vscode.typescript-language-features" } - 全局
editor.defaultFormatter对多数语言无效，必须按语言 ID 写块配置 - 如果用了 Prettier，确保
prettier.prettierPath指向项目内node_modules/.bin/prettier（而非全局路径），否则远程开发或 pnpm 项目里会报 “No formatter installed”
真正难排查的不是快捷键本身，而是它背后那三层依赖：系统输入法没吞键、VS Code 读到了正确的语言 ID、对应语言的格式化器进程真正在运行。三者任一断开，Shift+Alt+F 就只是个安静的组合键。
