VSCode格式化快捷键失效通常因配置覆盖而非损坏，90%情况删掉用户级keybindings.json即可恢复；需依次排查按键被系统/输入法拦截、插件冲突、减号禁用、语言模式错配及格式化扩展未启用等问题。
VSCode格式化快捷键失效，不是“坏了”，而是某一层配置覆盖了默认行为——90% 的情况，删掉用户级 keybindings.json 就能恢复。
快捷键完全没反应？先看按键是否送达 VS Code
按下 Shift+Alt+F（Windows/Linux）或 Cmd+Shift+I（macOS）后编辑器毫无反应，连光标都不闪，大概率是系统或输入法把按键截胡了。
- 在 VS Code 窗口焦点下按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools，打开控制台，再按格式化快捷键 —— 如果控制台空空如也，说明按键根本没传进来 - Windows 用户重点关掉搜狗/微软拼音的「Shift+Alt 切换中英文」；macOS 用户检查「系统设置 → 键盘 → 快捷键」里是否启用了「强制退出」或「聚焦搜索」等占用
Cmd+Shift+I的选项 - 临时禁用所有插件（
Ctrl+Shift+P→Developer: Disable All Installed Extensions），再试 —— 若恢复，说明某个插件注册了同名命令但没实现逻辑，导致静默失败
keybindings.json 里藏着一个减号就废掉快捷键
很多人手动改过快捷键，却不知道 {"key": "shift+alt+f", "command": "-editor.action.formatDocument"} 这行里的减号 - 是“取消绑定”语义，等于主动禁用。
- 按
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts (JSON)，打开的是用户级keybindings.json - 搜索
editor.action.formatDocument，确认没有带减号的禁用项；也别留空数组[]，VS Code 会把它当有效配置处理 - 最彻底的办法：清空该文件全部内容，保存，然后重启 VS Code —— 它会自动回退到内置默认映射，不需要重装或重置整个编辑器
语言模式错配，格式化能力直接被绕过
右下角状态栏显示 Plain Text 或 JSONC，VS Code 就不会调用内置 JSON 格式器，哪怕你按对了快捷键也没用。
- 点击右下角语言标识，手动选
JSON（不是JSONC），尤其对.json文件；.vue文件误识别为HTML也会跳过 Volar/Prettier - 运行
Ctrl+Shift+P→Format Document With…，如果列表为空，说明当前语言没装或没启用对应格式化扩展 - 检查
settings.json里有没有写死禁用项，比如"[json]": { "editor.formatOnSave": false }，或者"editor.defaultFormatter"指向了一个不存在的扩展 ID
格式化命令灰色不可用？本质是“找不到执行者”
菜单里“格式化文档”置灰、快捷键变暗，不是界面 bug，是 VS Code 明确判断当前上下文无法安全执行格式化。
- 它依赖三个硬条件同时满足：正确的
languageId（如typescriptreact）、已启用的 formatter 扩展、且该扩展声明了provideDocumentFormattingEdit能力 - 运行
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes，看右上角显示的languageId是什么，再对照settings.json中editor.defaultFormatter的键名是否精确匹配（"typescript"对.tsx文件无效） - 工作区设置（
.vscode/settings.json）优先级高于用户设置，如果项目里有这个文件，先检查它是否把editor.defaultFormatter设成了null或空字符串
真正容易被忽略的点：格式化不是单点功能，而是快捷键 + 语言识别 + 扩展能力 + 配置匹配四层链路。断掉任何一环，表现都是“没反应”，但修复路径完全不同。别一上来就重装插件或重置设置，先用开发者工具看按键是否送达，再查语言 ID 和 keybindings.json 里那个要命的减号。
