VSCode保存格式化失效的根本原因是editor.formatOnSave、语言绑定与格式化器ID三者未对齐；需检查配置覆盖、右下角语言模式、defaultFormatter拼写（esbenp.prettier-vscode）、.prettierrc语法合法性及ESLint风格规则冲突。
VSCode保存时格式化失效，根本不是插件没装或开关没开这么简单——而是editor.formatOnSave、语言绑定、格式化器ID三者没对齐，缺一不可。
formatOnSave开了但没生效？检查是否被语言专属配置覆盖
全局设了"editor.formatOnSave": true，不代表所有文件都响应。VSCode 会优先采用语言专属设置（如"[javascript]"块），一旦该块里写了"editor.formatOnSave": false，全局设置就完全失效。
- 按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)，逐行检查是否有类似"[typescript]": { "editor.formatOnSave": false }的语句 - 推荐写法：在项目根目录的
.vscode/settings.json中显式声明目标语言块，例如：{"[javascript]": {"editor.formatOnSave": true},"[typescript]": {"editor.formatOnSave": true}} - 别依赖 GUI 设置界面——它容易受用户级/工作区级/语言级三层继承干扰，直接写 JSON 更可控
右下角不显示 Prettier？说明语言绑定失败
打开一个 .js 文件，看 VSCode 窗口右下角状态栏。如果显示的是 ESLint、None 或空白，而不是 Prettier，说明 VSCode 根本没把格式化任务交给它。
- 必须设置
editor.defaultFormatter，且值必须是esbenp.prettier-vscode（注意拼写，漏掉-vscode或写成prettier都会失败） - 对非标准语言（如
.html、.vue、.mdx），不能只靠全局 defaultFormatter，得单独加语言块：{"[html]": {"editor.defaultFormatter": "esbenp.prettier-vscode"}} - 快捷验证：右键文件 →
Format Document With…，如果列表里没有Prettier，或者点了没反应，就是绑定失败或插件未启用
.prettierrc 语法错误会导致静默退出
Prettier 遇到配置文件解析失败时，不会报错，也不会提示，而是直接放弃加载规则，退回到默认排版——你改了配置却看不到效果，大概率是这个原因。
-
.prettierrc必须是合法 JSON：不能有单引号、注释、尾随逗号；推荐用.prettierrc.json，内容示例：{"semi": true,"singleQuote": true,"tabWidth": 2} - 需要动态逻辑（比如按文件类型切换规则）？改用
prettier.config.js，导出方式要匹配项目模块系统：module.exports = { semi: true }（CommonJS）或export default { semi: true }（ESM） - 本地运行
npx prettier --debug-check index.js，它会明确指出哪一行、哪个键出错（比如把trailingComma拼成trailingcomma）
同时用 ESLint 和 Prettier？必须关闭 ESLint 的格式规则
ESLint 和 Prettier 规则重叠（比如 quotes、semi、comma-dangle）会导致“保存后又被改回去”，甚至报 Conflict 错误。
- ESLint 只管质量（未使用变量、潜在 bug），Prettier 只管排版（缩进、引号、换行）——这是现代工程的分工共识
- 在
eslint.config.js或.eslintrc.js中，禁用所有风格类规则：rules: { "quotes": "off","semi": "off","comma-dangle": "off" } - 若用
eslint-config-prettier，确保它放在 extends 数组末尾，覆盖前面所有冲突规则
最常被忽略的一点：Prettier 插件是否真正加载成功，取决于它能否读到有效的配置文件 + 被正确绑定到当前语言 + 不被 ESLint 的风格规则反向干扰。这三个环节任一断裂，都会表现为“保存无反应”。
