VSCode保存时格式化失效怎么解决？详细配置修复指南-VSCode-PHP中文网

VSCode保存格式化失效的根本原因是editor.formatOnSave、语言绑定与格式化器ID三者未对齐；需检查配置覆盖、右下角语言模式、defaultFormatter拼写（esbenp.prettier-vscode）、.prettierrc语法合法性及ESLint风格规则冲突。

vscode保存时格式化失效怎么解决？详细配置修复指南

VSCode保存时格式化失效，根本不是插件没装或开关没开这么简单——而是editor.formatOnSave、语言绑定、格式化器ID三者没对齐，缺一不可。

全局设了"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 更可控

打开一个 .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，或者点了没反应，就是绑定失败或插件未启用

Prettier 遇到配置文件解析失败时，不会报错，也不会提示，而是直接放弃加载规则，退回到默认排版——你改了配置却看不到效果，大概率是这个原因。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

.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 规则重叠（比如 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 的风格规则反向干扰。这三个环节任一断裂，都会表现为“保存无反应”。