统一代码格式化的关键是配置文件与执行时机：需安装对应语言格式化插件、在工作区设置editor.formatOnSave和editor.defaultFormatter、正确放置.prettierrc、用.editorconfig兜底、CI校验及锁定Prettier版本。
VSCode 代码格式化本身不难，难的是让团队所有人格式化结果一致——关键不在 VSCode 设置，而在统一的配置文件和执行时机。
怎么配 editor.formatOnSave 才真正生效
很多人开了这个选项却没效果，根本原因是：VSCode 默认不自带语言格式化器，它只是调用插件提供的格式化能力。
- 必须先安装对应语言的官方格式化插件（比如
esbenp.prettier-vscode之于 JavaScript/TypeScript，ms-python.python自带autopep8或black支持） - 确保
"editor.formatOnSave": true在工作区设置（.vscode/settings.json）里，而非仅用户全局设置——团队项目必须走工作区级配置 - 检查是否有冲突：比如同时启用 Prettier 和 ESLint 的“自动修复”可能互相覆盖，建议只留一个主力格式化器，并用
eslint.format.enable关闭 ESLint 的格式化通道
为什么 .prettierrc 放在项目根目录还是不生效
Prettier 只认它自己能“看到”的配置，而 VSCode 插件是否读取、读取哪一层，取决于路径解析逻辑和插件版本。
- 确保
.prettierrc文件名完全正确（支持.prettierrc.json、.prettierrc.js、prettier.config.js，但不支持prettier.json） - 如果项目是多根工作区（multi-root workspace），Prettier 默认只查当前打开的文件所在文件夹的配置，需在
.vscode/settings.json中显式指定："prettier.prettierPath": "./node_modules/prettier"并确认路径存在 - 运行
Prettier: Show Output命令（Ctrl+Shift+P），看控制台是否报错“Could not find config”，这能快速定位配置加载失败原因
团队格式不一致？别只靠人去开设置
靠成员手动开启 formatOnSave 或选对格式化工具，100%会出问题。必须把规则固化进工程本身。
- 在
.vscode/settings.json中写死："editor.defaultFormatter"（如"esbenp.prettier-vscode"）和"editor.formatOnSave" - 加
.editorconfig作兜底：定义缩进、换行符等基础风格，连 Notepad++ 都认，比纯 VSCode 配置更通用 - CI 加一道检查：用
prettier --check .或black --check .阻断不合规代码合入，比事后 Code Review 有效得多
最常被忽略的一点：格式化插件的版本差异会导致同一份 .prettierrc 输出不同。团队必须锁死 devDependencies 里的 prettier 版本，并在文档里注明“使用 npm run format 而非 VSCode 快捷键”，才能真正跨机器对齐。
