开启 editor.formatOnSave 后，VSCode 才会每次保存时自动按团队规则格式化代码；生效前提包括安装对应语言的格式化扩展、正确设置语言模式、配置有效且路径正确的格式化配置文件、工作区设置未覆盖关键项，并在 .vscode/settings.json 中明确指定 editor.defaultFormatter。
editor.formatOnSave 开启后，VSCode 才真正开始“替你守规矩”——不是靠人眼检查缩进或引号，而是每次 Ctrl+S 就自动按团队规则重排代码。没这一步，所有配置都只是摆设。
怎么让保存时自动格式化真正生效
很多人勾选了 Editor: Format On Save 却没效果，问题往往不在开关本身，而在背后缺一个“能干活的人”：
- 没装对应语言的格式化扩展（比如 JavaScript 文件没装
Prettier - Code formatter，VSCode 只会做基础缩进，不处理分号、逗号、引号） - 右下角语言模式显示为
Plain Text而非JavaScript或Python（点一下就能切回来） - 项目里有
.prettierrc或.eslintrc.js，但路径不对，或 JSON 格式有误（VSCode 不报错，只默默跳过） - 工作区设置（
.vscode/settings.json）覆盖了用户设置，而工作区里没写"editor.formatOnSave": true
为什么必须指定 editor.defaultFormatter
装了 Prettier、ESLint、Beautify 三个插件？VSCode 不知道该信谁。不指定默认格式化器，它可能随机调用一个，甚至 fallback 到内置简易格式器——结果就是同一份 JS 文件，A 同学保存后加了分号，B 同学保存后删了分号。
实操建议：
- 在项目根目录的
.vscode/settings.json中明确写死：{ "[javascript]": { "editor.defaultFormatter": "esbenp.pretterr-vscode" }, "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } } - 避免用全局设置指定默认格式器，否则换个项目就得手动切
- 如果用 Black 处理 Python，对应值是
ms-python.black-formatter，拼错就失效
.editorconfig 是跨编辑器风格底线
Prettier 管语义美化，.editorconfig 管最基础的“编辑行为”：空格还是 tab、换行符是 LF 还是 CRLF、是否删末尾空格。这些规则连 Vim、WebStorm、Sublime 都认，是团队里有人不用 VSCode 时的兜底保障。
一个最小可用的 .editorconfig 示例：
root = true[*] indent_style = space indent_size = 2 end_of_line = lf charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true
[*.py] indent_size = 4
注意：[*.py] 这种语言特化段落，比全局设置优先级高；但 VSCode 是否读取它，取决于是否安装了 EditorConfig for VS Code 插件（官方推荐，免费）。
格式化失效时，先查这三处
别急着重装插件——90% 的“格式化没反应”问题，出在这三个地方：
-
Ctrl+Shift+P→ 输入Format Document，看有没有报错提示（如 “No formatter found”） - 右下角语言模式旁，点击齿轮图标 → “Configure Language Specific Settings…” → 检查当前语言的
editor.defaultFormatter是否为空或错误 - 打开命令面板 →
Developer: Toggle Developer Tools→ Console 标签页，看是否有插件加载失败或配置解析错误（比如.prettierrc里多了一个逗号）
真正难的不是配一次，而是让所有人在不同系统、不同 VSCode 版本、不同 Node 环境下，都能读到同一份 .prettierrc、跑通同一个 prettier --write 命令——这需要把配置文件放进 Git，而不是只靠个人设置。
