必须同时满足三项硬性条件：editor.formatonsave为true、editor.defaultformatter精确设为"esbenp.prettier-vscode"、对应语言（如[javascript]）单独绑定该格式化器，缺一即导致保存时不触发prettier。
editor.formatOnSave 必须为 true，且 editor.defaultFormatter 必须设为 "esbenp.prettier-vscode" —— 否则保存时根本不会调用 Prettier，所谓“自动化”就是空谈。
为什么保存后代码毫无反应？三个硬性条件缺一不可
VSCode 不会主动把 Prettier 当成格式化工具，哪怕插件已装、配置文件已写，只要以下任意一项不满足，Ctrl+S 就等于没按：
-
editor.formatOnSave在当前作用域（用户设置 / 工作区.vscode/settings.json）中必须显式设为true -
editor.defaultFormatter必须精确设为"esbenp.prettier-vscode"（注意短横线和大小写，填prettier或Prettier都无效） - 对应语言必须有绑定：比如打开一个
.ts文件，右下角状态栏显示的不是Prettier，而是ESLint或空白，说明"[typescript]"块里没配editor.defaultFormatter
最稳妥的做法是直接在项目根目录的 .vscode/settings.json 里写死：
{
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true
},
"[typescript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true
},
"[vue]": {
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true
}
}
.prettierrc.json 不生效？路径和语法比内容还关键
VSCode 的 Prettier 插件只认项目根目录（即你执行 code . 打开的那个文件夹）下的配置文件，且只支持有限几种命名和格式：
- 接受的文件名：
.prettierrc.json（推荐）、.prettierrc、prettier.config.js（仅支持module.exports = {}，export default在 ESM 项目中会静默失败） - 不允许 JSON 注释、末尾逗号、BOM 字符；
.prettierrc.json写错一个逗号，Prettier 就直接跳过，回退到默认规则（semi: true,tabWidth: 2） - 不读取
package.json里的prettier字段 —— 这是 CLI 行为，VSCode 插件不认
一个最小可用示例：
{"semi": false,"singleQuote": true,"tabWidth": 2,"printWidth": 80,"trailingComma": "es5"}
和 ESLint 一起用时，格式越修越乱？冲突点就在规则重叠
ESLint 自带的 quotes、semi、comma-dangle 等规则，和 Prettier 功能完全重复。两者同时启用自动修复，就会出现“保存一次，分号消失；再保存一次，分号又回来”的循环。
- 必须安装
eslint-config-prettier：npm install --save-dev eslint-config-prettier - 在
.eslintrc的extends数组里，把它放在**最后一位**：["eslint:recommended", "prettier"] - 关掉 ESLint 的格式化开关：
"eslint.codeAction.onSave.fix": false（或删掉这一项），让 ESLint 只做质量检查，不动代码格式
如果用了 eslint-plugin-prettier，还需确认它已启用并配置了 "prettier/prettier": "error" 规则，否则 ESLint 不会校验 Prettier 格式是否合规。
TypeScript 或 Vue 文件不格式化？语言标识没对上
VSCode 对文件类型的识别有时很微妙：.ts 文件可能被识别为 typescriptreact（尤其在 Next.js 或 Vite + React 项目中），而你的配置只绑定了 [typescript]，结果 <script setup lang="ts"></script> 里的代码就漏掉了。
- 看右下角状态栏的语言模式名称，不是图标，是文字（比如显示
TypeScript React而非TypeScript） - 如果是
TypeScript React，就得加一条："[typescriptreact]": {"editor.defaultFormatter": "esbenp.prettier-vscode"} - Vue 单文件组件需要单独声明
[vue]块，否则<script></script>和<template></template>都不会被格式化 - 若用 Astro、Svelte 等框架，同理需查清 VSCode 识别出的实际语言 ID，再补对应块
真正麻烦的不是配多少项，而是 VSCode 语言 ID 和你直觉认为的不一样 —— 多数问题都卡在这一步。
