保存时自动格式化没生效需依次确认：格式化扩展已安装启用、文件语言模式正确、Format Document With...有可用选项、editor.formatOnSave为true、formatOnSaveMode设为modifications（Prettier推荐）、项目级配置（如.prettierrc或pyproject.toml）被正确读取。
保存时自动格式化没生效？先确认格式化器已安装并启用
VS Code 本身不自带代码格式化能力，必须装对应语言的格式化扩展（比如 esbenp.prettier-vscode、ms-python.python），且该扩展得真正“能干活”。常见现象是点了保存没反应，或提示 No formatter installed。
- 检查当前文件类型右下角语言模式是否正确（如 .js 文件显示的是
JavaScript而不是Plain Text） - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Format Document With...，看有没有可用选项；如果列表为空，说明没装或没激活格式化器 - Python 用户注意：
ms-python.python自带autopep8、black、yapf支持，但需在设置里指定python.formatting.provider，否则保存时不会触发
关键设置项：editor.formatOnSave 必须为 true
这个开关控制“保存即格式化”的总闸门。它默认是 false，很多人改了其他配置却漏掉它。
- 在设置界面搜索
format on save，勾选Editor: Format On Save - 或直接编辑
settings.json，确保有这一行："editor.formatOnSave": true
- 注意：工作区级设置（
.vscode/settings.json）会覆盖用户级设置，如果项目里写了"editor.formatOnSave": false，那整个项目都无效
为什么保存后格式没变？可能被 formatOnSaveMode 干扰了
VS Code 1.84+ 引入了 editor.formatOnSaveMode，默认值是 file，但某些格式化器（尤其是 Prettier）在处理大文件或含错误语法时，可能跳过格式化——表面看像“没生效”，其实是被静默放弃了。
- 如果你用的是 Prettier，建议显式设为
modifications（只格式化修改过的行），避免整文件卡住："editor.formatOnSaveMode": "modifications"
-
file模式要求文档语法合法，遇到Unterminated string literal这类错误时直接放弃；modifications更宽容，适合边写边调的场景 - Python 用户若用
black，不受此影响，但要注意black默认不格式化语法错误文件，和 VS Code 的行为是一致的
多人协作项目里，别让本地设置覆盖团队约定
editor.formatOnSave 是个人设置，但格式效果取决于谁来格式化——Prettier 配置、ESLint 规则、pyproject.toml 里的 [tool.black]，这些才是真正决定“怎么格式”的东西。
- 项目根目录放
.prettierrc或prettier.config.js，比你在 VS Code 里调缩进空格数更可靠 - Python 项目优先用
pyproject.toml配black和isort，VS Code 只负责调用它们，别试图在 UI 里配python.formatting.blackArgs去覆盖 - 容易被忽略的一点：某些格式化器（如
prettier）需要prettier.resolveConfig设为true才读项目级配置，否则永远走默认规则
格式化不是开关一开就完事，它是个链路：文件类型 → 格式化扩展启用 → 编辑器开关打开 → 实际格式化器读到正确配置 → 没被语法错误拦住。少一环，保存就安静如鸡。
