VSCode保存时自动格式化需同时开启editor.formatOnSave并为每种语言指定defaultFormatter，否则即使安装Prettier/Black/ESLint也无效；全局设置defaultFormatter会导致非兼容语言报错。
VSCode 默认不自动格式化代码，哪怕你装了 Prettier、Black 或 ESLint，也必须手动开启 editor.formatOnSave 并为对应语言指定 editor.defaultFormatter，否则保存时什么都不会发生。
怎么打开“保存时自动格式化”开关
这个开关不是靠插件按钮控制的，而是编辑器核心设置。最直接的方式是：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）打开设置 - 右上角搜索框输入
format on save - 勾选
Editor: Format On Save
也可以直接编辑 settings.json，加一行：
"editor.formatOnSave": true注意：这个设置只是“触发器”，它不决定“用谁来格式化”——那得靠下一步。
为什么保存后没反应？大概率是没设默认格式化器
VSCode 不会自动从已安装的扩展里猜你要用哪个格式化工具。即使只装了 esbenp.prettier-vscode，它也不会默认选它。
- 右键编辑器空白处 →
Format Document With...→ 选中你的格式化器（如Prettier）→ 点击Configure Default Formatter... - 或者在
settings.json中按语言指定，例如："[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }<br>"[python]": { "editor.defaultFormatter": "ms-python.black-formatter" } - 切忌写成全局形式：
"editor.defaultFormatter": "esbenp.prettier-vscode"——这会让所有语言都尝试用 Prettier，而 Python、Go 等会直接失败
如果右下角状态栏显示 None，说明当前文件没匹配到任何格式化器；出现 No formatter installed for 'typescript' 这类报错，就该去检查 [typescript] 配置和扩展是否安装正确。
多个格式化工具共存时容易打架，怎么避免
常见冲突场景是 JavaScript/TypeScript 项目同时启用 Prettier 和 ESLint 的格式化能力。它们会互相覆盖缩进、分号、引号等规则，导致保存后光标乱跳、代码反复重排。
- 停用非主力格式化器：比如只留
esbenp.prettier-vscode，禁用dbaeumer.vscode-eslint的格式化功能（关掉eslint.format.enable） - 若需 ESLint 修复能力，改用
editor.codeActionsOnSave："editor.codeActionsOnSave": { "source.fixAll.eslint": true }这样 ESLint 只负责修复问题，格式化仍由 Prettier 统一执行 - 项目级配置优先于用户设置：检查项目根目录是否有
.vscode/settings.json，里面可能写了"editor.formatOnSave": false，会直接覆盖你的全局设置
大文件或远程开发时格式化卡顿，可以调什么
VSCode 1.84+ 引入了 editor.formatOnSaveMode，默认值 file 是安全的；但有人误设为 modifications 后发现格式化失效或变慢。
-
modifications模式依赖 diff 计算改动范围，对 >2MB 文件或含 Git 冲突标记（<<<<< HEAD）的文件容易失败，且部分格式化器（如 Prettier）根本不支持增量格式化 - 性能敏感场景，建议保持默认
file，或干脆关闭editor.formatOnSave，改用快捷键Shift + Alt + F手动触发 - 远程开发（WSL、Dev Container）中，
files.autoSave有时会被代理拦截，此时格式化也可能静默跳过——先确认自动保存本身是否生效
真正起作用的永远是两件事：开关开了，且 VSCode 明确知道“对哪种语言、用哪个扩展来格式化”。其余都是优化项，别在基础没跑通前调参数。
