VSCode格式化“时灵时不灵”的根本原因是多个格式化器争抢控制权或语言ID配置不匹配;必须显式为每种languageId(如[vue]、[typescriptreact])配置editor.defaultFormatter,禁用eslint.format.enable,并通过Output面板日志确认实际调用的格式化器。

VSCode格式化“时灵时不灵”,基本不是插件坏了,而是多个格式化器在抢控制权,或者语言识别、配置优先级没对齐——只要锁死 editor.defaultFormatter 并禁用冲突能力,就能稳定下来。
为什么保存后格式化有时生效、有时静默跳过
根本原因是 VSCode 没法确定该用谁来格式化。它会按顺序查:当前文件的语言 ID → 该语言是否配了 editor.defaultFormatter → 对应扩展是否启用且能响应 → 是否被其他设置(如 eslint.format.enable)中途截胡。
- 右下角状态栏显示
Vue,但 settings.json 里只配了[javascript],没配[vue],那 .vue 文件就没人管 -
eslint.format.enable默认为true,哪怕你装了 Prettier,ESLint 也会在保存时偷偷调eslint --fix,和 Prettier 规则一撞,结果就是缩进乱、分号忽有忽无 - 工作区设置(
.vscode/settings.json)覆盖了用户设置,而你只改了用户层,工作区里却关着editor.formatOnSave
如何确认当前文件到底用了哪个格式化器
别靠猜,直接看 VS Code 实际调用日志。这是唯一可信的判断方式。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(Mac),输入Developer: Toggle Developer Tools - 切换到
Output面板 → 选择Log (Window)→ 搜索format - 看到类似
[Extension Host] Formatting with esbenp.prettier-vscode才算真正命中;如果看到vscode.typescript-language-features,说明 TypeScript 内置格式器接管了,editor.defaultFormatter配错了或没配
必须显式配置每种 languageId 的 defaultFormatter
全局 editor.defaultFormatter 对单文件组件(如 .vue)、.tsx、.md 等混合类型完全无效。VSCode 只认方括号里的 language ID,拼写、大小写、有无后缀都必须严丝合缝。
- 查准确 ID:按
Ctrl+K M→ 看弹出列表里显示的名称,比如Vue对应[vue],TypeScript React对应[typescriptreact],JavaScript React是[javascriptreact] - 在
settings.json中逐个配,不能省略:{ "[vue]": { "editor.defaultFormatter": "Vue.volar" }, "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } } - 禁用 ESLint 的格式能力:
"eslint.format.enable": false,否则它会在 Prettier 之后再跑一遍,结果不可控
选中代码格式化失效?关键在 rangeFormatting 支持
即使 Prettier 插件已安装,Ctrl+K Ctrl+F 仍可能无反应——因为 Prettier 默认不实现 provideDocumentRangeFormattingEdits 接口,或者插件版本太老。
- 确保使用较新版本的
esbenp.prettier-vscode(v12.0+),旧版默认关闭 range 格式化 - 检查插件设置里有没有
prettier.rangeFormatEnable选项,设为true - 若用 Volar 处理 Vue 的
<script></script>块,需确认它是否支持对选中 JS/TS 片段格式化;不支持时,可临时切语言模式为javascript或typescript再试
最常被忽略的一点是:language ID 必须和 VS Code 当前识别的完全一致,差一个字母或大小写就静默失败;而日志输出才是唯一真实反馈,别信右下角状态栏的显示——它有时只是缓存。


















