打开开发者工具后先看Console是否有红字报错：插件不兼容、命令未找到、模块加载失败三类错误，再检查Format Document With列表是否为空及formatter是否显式启用，最后确认设置优先级覆盖问题。
打开开发者工具后看什么？重点盯这三类日志
格式化没反应，第一件事不是改配置，而是打开控制台看有没有红字。按 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools → 切到 Console 标签页，再按一次格式化快捷键（比如 Shift+Alt+F），立刻观察输出：
- 出现
Extension 'esbenp.prettier-vscode' is not compatible with Code '1.102.3'：插件被 VSCode 主动禁用，版本声明不匹配 - 出现
command 'editor.action.formatDocument' not found：当前语言 ID 没注册任何 formatter，不是插件没装，是绑定断了 - 出现
Failed to load module 'prettier'或路径报错：插件试图调 CLI 但找不到可执行文件，prettier.prettierPath配错了或全局没装
注意：控制台清空后按快捷键没新日志，说明按键根本没进 VSCode —— 很可能是输入法或系统快捷键劫持了 Shift+Alt+F。
Format Document With 列表为空？说明语言绑定失败
按 Ctrl+Shift+P → 运行 Format Document With…，如果列表里压根没有 Prettier、ESLint 或你装的其他 formatter，基本可以排除“插件坏了”，而是语言 ID 绑定失效。常见原因：
- 右下角状态栏显示
Plain Text或Unknown：VSCode 不会对这类语言加载任何 formatter，哪怕文件后缀是.vue - settings.json 里还用着旧语言 ID：
"[vue]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }在 Volar 2.x 后已无效，得改成"[vue-html]": { ... } -
editor.defaultFormatter值写错：必须是完整 ID，比如esbenp.prettier-vscode，不能是prettier、prettier-vscode或大小写错误
验证方法：手动点击右下角语言名 → 输入真实语言 ID（如 typescriptreact）→ 回车，再开一次 Format Document With… 看是否出现。
控制台没报错但格式化还是不动？检查 formatter 是否真激活
有些插件（尤其是新版）不再自动启用服务，即使装了、没报错，也可能处于“静默待命”状态。这时控制台干净，但功能不工作：
- XML Tools 升级后默认关闭
xml.format.enable，即使editor.formatOnSave是 true，也完全跳过格式化 - ESLint 插件若未开启
eslint.format.enable，它不会响应editor.action.formatDocument，哪怕你设了dbaeumer.vscode-eslint为 defaultFormatter - Prettier 插件在项目里用了
pnpm，但prettier.prettierPath指向全局安装路径，而实际该路径下没这个二进制文件
这类问题往往需要去对应插件的设置页翻一遍开关项，而不是只盯着通用格式化配置。别信“装了就等于能用”——新版扩展越来越倾向显式启用。
为什么改了 settings.json 还没用？优先级和覆盖逻辑要理清
VSCode 的设置有四层优先级（从高到低）：命令行参数 → 工作区 .vscode/settings.json → 用户 settings.json → 默认值。很多“改了没反应”其实是被更高优先级覆盖了：
- 工作区
.vscode/settings.json里写了"[javascript]": { "editor.formatOnSave": false }，全局开了也没用 - 用户设置里启用了
editor.formatOnSave，但某个语言块里又写了"[jsonc]": { "editor.formatOnSave": false }，JSONC 文件就永远不会自动格式化 - 某些插件（如 ESLint）会注入自己的语言专属配置块，它可能在你没察觉时覆盖了
editor.defaultFormatter
排查时直接按 Ctrl+Shift+P → Preferences: Open Workspace Settings (JSON) 和 Preferences: Open User Settings (JSON) 对比查看，别只依赖 UI 设置面板。
