VS Code 代码格式化失败主因是格式化工具未安装、未正确配置或配置冲突；需统一安装 prettier、设置默认格式化器、配置 .prettierrc 和 .vscode/settings.json，并用 eslint-config-prettier 与 eslint-plugin-prettier 协同避免样式规则冲突。
VS Code 代码格式化失败，通常不是编辑器坏了，而是格式化工具没装、没配对、或配置冲突了——尤其当团队成员各自安装不同插件、用不同配置时，formatOnSave 一开就报错或根本没反应。
为什么 prettier 或 eslint --fix 在 VS Code 里不生效
VS Code 本身不格式化代码，它只是调用你指定的格式化工具（如 prettier、eslint、clang-format）。常见失效原因：
-
prettier没全局或本地安装（npm install -D prettier或npm install -g prettier） - VS Code 没选中正确的默认格式化工具（右键 → “Format Document With…” → 选
Prettier，并设为默认） - 项目根目录下缺
.prettierrc或prettier.config.js，导致工具找不到规则而静默退出 -
eslint和prettier冲突：比如eslint-plugin-prettier没启用，或eslint-config-prettier没关掉 ESLint 自带的样式规则
如何让团队所有人格式化结果完全一致
靠人手动选格式化器不行，得靠配置文件 + 编辑器约束。关键动作是统一“谁来格式化”和“按什么格式化”：
- 在
package.json的devDependencies中固定prettier版本（如"prettier": "3.3.3"），避免^导致升级后行为变化 - 所有格式化规则写进
.prettierrc（JSON 格式）或prettier.config.js（支持 JS 逻辑），禁止用 VS Code 用户设置覆盖 - 加
.editorconfig作兜底：统一缩进、换行符、字符集等基础项，连 Notepad++、WebStorm 都认 - 在
.vscode/settings.json中强制开启："editor.formatOnSave": true，并锁定格式化器："editor.defaultFormatter": "esbenp.prettier-vscode" - 用
husky+lint-staged在 git commit 前自动格式化，绕过个人编辑器差异
eslint 和 prettier 能不能一起用？怎么配才不打架
能一起用，但必须明确分工：ESLint 负责逻辑/安全检查（如 no-unused-vars），Prettier 负责样式（如引号、换行）。冲突点在于 ESLint 自带的样式规则（如 quotes、semi）会跟 Prettier 对着干。
- 装两个包：
eslint-config-prettier（关闭 ESLint 所有样式规则）、eslint-plugin-prettier（把 Prettier 当成 ESLint 一条规则跑） - 在
.eslintrc.cjs中，把prettier放在extends数组最后，确保它能覆盖前面的样式规则 - 加这条配置：
"plugin:prettier/recommended"，它会自动启用eslint-plugin-prettier并关掉冲突规则 - 别在
rules里手动写"prettier/prettier": "error"——recommended已包含，重复写反而容易漏掉自动修复开关
最常被忽略的一点：VS Code 的工作区设置（.vscode/settings.json）优先级高于用户设置，但低于命令行启动时传入的 --disable-extensions。如果某人禁用了 esbenp.prettier-vscode 插件，哪怕配置全对也没用——所以团队初始化项目时，最好附一句“请确认已启用 Prettier 插件”。
