VSCode保存时自动格式化失效需三步排查：先确认已安装并设为默认的格式化扩展；再确保settings.json中"editor.formatOnSave":true与"files.autoSave"非"off"同时启用；最后检查文件关联、作用域设置及项目级配置（如.editorconfig、.prettierrc）是否正确。
保存时自动格式化没反应？先确认格式化器已安装并设为默认
VSCode 本身不带代码格式化能力，必须装对应语言的格式化扩展（比如 esbenp.prettier-vscode 对 JavaScript/TypeScript，ms-python.python 自带 autopep8 或 black 支持）。
没装扩展，开再多设置也没用。
- 检查是否已安装：打开扩展面板（
Ctrl+Shift+X），搜语言名 + “formatter”，确认有绿色“已启用”标识 - 确保设为默认：右键文件标签 →
Format Document With...→ 选中你想要的格式化器 → 点击Configure Default Formatter - 注意：不同文件类型（
.js、.py、.ts）可能需要分别设置，默认不继承
如果只在某个文件里按 Shift+Alt+F 能格式化，但保存时不触发，大概率是默认格式化器没配对。
settings.json 里 autoSave 和 formatOnSave 必须同时开启
这两个配置是独立开关，缺一不可。常见错误是只开了 "editor.formatOnSave": true，却忘了 "files.autoSave": "onFocusChange" 或 "onWindowChange" —— 这样代码改了但没手动保存，自然不会格式化。
-
"editor.formatOnSave": true是触发格式化的前提 -
"files.autoSave": "off"（默认值）意味着你必须主动按Ctrl+S才会走格式化流程 - 如果想“写完切走就保存+格式化”，用
"files.autoSave": "onFocusChange"；想“关窗口前统一处理”，用"onWindowChange" - Python 用户注意：
ms-python.python扩展还依赖"python.formatting.provider"配置（如"black"或"autopep8"），否则即使formatOnSave开了也静音
{
"editor.formatOnSave": true,
"files.autoSave": "onFocusChange",
"python.formatting.provider": "black"
}
格式化被禁用？检查文件关联、作用域和排除规则
VSCode 会按文件后缀匹配语言模式，再找对应格式化器。如果文件没被识别成目标语言（比如 .jsx 被当成 plaintext），formatOnSave 就直接跳过。
- 看右下角状态栏：确认当前语言模式正确（如显示
JavaScript React，不是Plain Text）；点它可手动切换 - 检查工作区设置是否覆盖了用户设置：打开命令面板（
Ctrl+Shift+P）→ 输入Preferences: Open Workspace Settings (JSON)，看有没有"[javascript]": { "editor.formatOnSave": false }这类显式禁用项 -
"editor.formatOnSaveTimeout"默认 750ms，超时就放弃。大文件或慢格式化器（如某些 ESLint 集成）可能被截断，可适当调高（但别超过 2000） -
"files.exclude"或"eslint.options" → "cwd"错误路径，也可能让格式化器找不到配置，返回静默失败
多人协作项目里，团队格式化行为不一致？靠 .editorconfig + 项目级配置兜底
用户设置管不住别人，也不该管。真正可靠的是把格式规则沉到项目里：用 .editorconfig 统一缩进、换行风格，再配合语言专属配置文件（如 .prettierrc、.eslintrc.js、pyproject.toml）。
-
.editorconfig被 VSCode 原生支持，无需插件，优先级高于用户设置 - Prettier 用户务必加
"prettier.requireConfig": true，避免它用自己的默认规则覆盖项目.prettierrc - Python 项目若用
black，确保pyproject.toml里有[tool.black]区块，且 VSCode 的python.formatting.provider指向black - 格式化器版本差异很大：团队成员用的
prettier是 2.8 还是 3.0，输出可能不同。建议用package.json的devDependencies锁定版本，并通过npx prettier调用
有些项目把格式化逻辑绑在 husky + lint-staged 里，这时候 VSCode 的 formatOnSave 只是辅助，别指望它解决所有问题。
