先确认右下角语言模式是否正确，再检查 editor.defaultformatter 配置是否匹配插件完整 id（如 esbenp.prettier-vscode），接着验证 .prettierrc 格式合法性及 prettier.requireconfig 设置，最后排查工作区 settings.json 是否覆盖全局配置。
“已安装格式化插件但不工作”怎么快速定位
VSCode 显示插件已启用，执行 Format Document 却无反应或报 There is no formatter for 'xxx'-files installed.，这几乎从来不是插件“没装好”，而是 VSCode 找不到能响应当前上下文的 formatter 实例。核心排查顺序是：语言模式 → 默认绑定 → 插件加载状态。
常见错误现象：
- 右下角状态栏显示
Plain Text或HTML，但你正编辑的是.vue文件 -
Ctrl+Shift+P→Format Document With...列表里压根没有 Prettier / ESLint - 开发者工具 Console 里出现
Extension 'esbenp.prettier-vscode' is not compatible with Code '1.102.3'
实操建议：
- 先看右下角语言模式是否正确；不对就点它 →
Configure Language Specific Settings→ 确认当前文件被识别为vue-html（非vue）、typescript（非javascript）等新版 ID - 运行
Ctrl+Shift+P→Developer: Toggle Developer Tools，切到 Console，再触发一次格式化，盯住红字报错 - 进
Extensions: Show Installed Extensions，右上角筛选器选Disabled—— 很多插件被静默禁用，UI 上仍显示“已启用”
editor.defaultFormatter 配置为什么总写错
这个配置项是格式化能否走通的闸门，但极易因拼写、作用域或大小写问题失效。它不是“选一个名字”，而是必须精准匹配插件的完整发布 ID。
关键细节：
-
editor.defaultFormatter的值必须是esbenp.prettier-vscode，不能简写成prettier、prettier-vscode或漏掉作者前缀esbenp. - 全局设置对
html、jsonc、markdown等语言无效，必须用语言专属块："[html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - Volar 2.x 后，
.vue文件默认语言 ID 是vue-html和vue-postcss，旧配置"[vue]": { ... }完全失效 - 如果同时启用了 ESLint 和 Prettier，且都设了 defaultFormatter，VSCode 可能随机选一个——右键 →
Format Document With…→Configure Default Formatter…手动指定才可靠
prettier.config.js 或 .prettierrc 出错会静默失败
Prettier 遇到配置文件解析失败时，不会弹窗、不报错、不提示，直接退回到“不应用任何规则”的默认行为。你改了 semi 没生效？大概率是配置文件本身没被读进去。
容易踩的坑：
-
.prettierrc是 JSON 格式，不允许注释、单引号、尾随逗号、key 不加双引号 —— 任一违规都会导致整个文件被跳过 -
trailingComma拼成trailingcomma，或endOfLine写成"LF"（必须小写"lf"） -
prettier.requireConfig设为true，但项目里没放配置文件，Prettier 就彻底罢工 - monorepo 中，VSCode 从当前文件路径向上找第一个
.prettierrc，不是工作区根目录 —— 子包里漏配就会回退到默认
验证方法：
- 终端执行
npx prettier --debug-check index.ts，它会明确指出哪一行、哪个 key 解析失败 - 临时在
settings.json加"prettier.requireConfig": false，如果这时格式化突然正常，就是配置文件问题 - 优先用
prettier.config.js替代 JSON 文件，它支持 JS 语法和注释，容错性高得多
工作区 settings.json 覆盖了你的全局配置
很多人只改了用户设置（全局），却忽略了项目根目录下的 .vscode/settings.json。这个文件的优先级高于用户设置，哪怕只写了 "[javascript]": { "editor.formatOnSave": false }，所有 JS 文件的自动格式化就全被关死。
检查要点：
- 运行
Ctrl+Shift+P→Preferences: Open Workspace Settings (JSON)，确认里面没显式关闭editor.formatOnSave或覆盖editor.defaultFormatter - 如果项目需要差异化配置（比如某个子包用 ESLint 格式化，其他用 Prettier），必须在对应子目录的
.vscode/settings.json中精确声明语言块，而不是靠全局 fallback - 团队协作时，
.vscode/settings.json应只存 editor 行为开关（如formatOnSave），不要放具体 formatter ID —— 那属于项目级配置，应由package.json+.prettierrc约束
最常被忽略的一点：VSCode 的 formatter 绑定是“语言 ID + 插件 ID + 配置文件存在性”三者共同生效的结果。少一个环节，它就安静地放弃，而不是报错提醒你。调试时别只盯着插件是否启用，要像查电路一样，一段一段确认信号有没有真正通到文件上。
