必须为每种语言单独配置默认格式化器,如"[javascript]": {"editor.defaultFormatter": "esbenp.prettier-vscode"};启用prettier.requireConfig:true强制读取配置;确保editor.formatOnSave为true且language mode正确。

装了 Prettier 插件但按 Shift+Alt+F 没反应,或者保存后代码完全没变化——不是插件坏了,而是 VSCode 根本没把它和当前文件“连上线”。默认格式化器不是全局开关,得按语言一个个绑。
为什么 editor.defaultFormatter 顶层设置基本无效
VSCode 的 editor.defaultFormatter 放在 settings.json 顶层,只对 language mode 为 “Plain Text” 这类未识别语言的文件起作用。而你打开的 .js、.ts、.vue 文件都有明确 language ID,VSCode 会优先查 "[javascript]" 这类语言专属块。
- 直接写
"editor.defaultFormatter": "esbenp.prettier-vscode"在顶层,对 JS/TS 文件毫无影响 - 必须用语言 ID 包裹,例如
"[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - language ID 必须准确:React TSX 文件是
typescriptreact,不是typescript;Vue SFC 是vue,不是html - 右下角状态栏显示的语言名(如 “TypeScript React”)就是你要配的 ID,大小写和中划线都不能错
怎么快速配对语言和 Prettier(不手写 JSON)
别一上来就改 settings.json。VSCode 提供了更稳的路径,能自动匹配 language ID 并写对格式化器 ID:
- 打开一个
.js文件 → 右键编辑器任意位置 → 选 “格式化文档时使用” → 点 “配置默认格式化程序” - 在弹出列表里选 “Prettier - Code formatter”,并勾选 “设为默认”
- VSCode 会自动生成类似这样的块:
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - 重复该操作,为
.ts、.json、.md等分别配一次,避免漏掉关键语言
prettier.requireConfig: true 是个隐藏开关
即使你绑定了 Prettier,它也可能静默跳过格式化——尤其当你写了 .prettierrc.json 却发现规则没生效时。原因很可能是插件没强制读配置。
- 默认情况下,Prettier 插件允许 fallback 到内置规则(比如
semi: true、singleQuote: false) - 加这一行配置,才能让它“非配置不干活”:
"prettier.requireConfig": true - 这个选项必须写在
settings.json顶层,不支持放在语言块里 - 配合
.prettierrc.json放在项目根目录,才真正锁定团队规范
保存时没触发?检查这三处是否全开
格式化器绑对了、配置文件也有了,但 Ctrl+S 后还是没变化——大概率卡在这三个地方:
-
editor.formatOnSave必须为true(建议放用户级设置,避免每个项目重复开) - 对应语言的专属设置不能覆盖它,比如
"[javascript]": { "editor.formatOnSave": false }会直接关死 - 文件 language mode 必须正确:右下角显示 “JavaScript”,而不是 “Plain Text” 或 “TypeScript React”(后者需单独配
"[typescriptreact]")
多根工作区下,.prettierrc 只在自己所在根目录生效,跨子包不继承——这是最常被忽略的路径陷阱。











