VSCode自动保存需配置files.autoSave为afterDelay等值并注意工作区设置覆盖；格式化需同时启用editor.formatOnSave并按语言设置editor.defaultFormatter；推荐用.editorconfig和.prettierrc统一团队规则。
VSCode 自动保存不生效？检查 files.autoSave 设置值
VSCode 默认不开启自动保存，必须显式配置。常见误区是只改了用户设置，却忽略了工作区设置的覆盖优先级。
-
files.autoSave有四个可选值：off（默认）、afterDelay、onFocusChange、onWindowChange；推荐用afterDelay，再配合files.autoSaveDelay（单位毫秒，建议设为1000） - 若在项目根目录存在
.vscode/settings.json，它会覆盖全局设置；打开命令面板（Ctrl+Shift+P），输入Preferences: Open Workspace Settings (JSON)可确认当前生效位置 - 某些远程开发（如 WSL、Dev Container）场景下，
files.autoSave可能被插件或远程代理拦截，此时需检查Remote - WSL或对应扩展的文档是否声明了限制
格式化没反应？确认 editor.formatOnSave 和默认 formatter
仅开启 editor.formatOnSave 不够，VSCode 还需要知道“用谁来格式化”。没有匹配的语言 formatter，保存时不会触发任何格式化动作。
- 先确保已安装对应语言的 formatter 插件，例如：JavaScript/TypeScript 用
esbenp.prettier-vscode，Python 用ms-python.black-formatter或ms-python.autopep8 - 设置
editor.defaultFormatter必须按语言指定，例如："[javascript]": "esbenp.prettier-vscode"；不能只写"editor.defaultFormatter": "esbenp.prettier-vscode"（这会全局生效但可能出错） - 若保存后仍无格式化，打开命令面板运行
Developer: Toggle Developer Tools，在 Console 中查看是否有类似Failed to format document: Error: No formatter registered for 'typescript'的报错
保存时格式化卡顿或崩溃？避开 editor.formatOnSaveMode 的陷阱
VSCode 1.84+ 引入了 editor.formatOnSaveMode，它控制格式化范围，默认值 file 是安全的，但设成 modifications 容易引发问题。
-
modifications模式只格式化“本次编辑改动过的行”，看似高效，但依赖 diff 算法；当文件较大（>2MB）、或存在未提交的 Git 冲突标记时，diff 可能失败，导致格式化静默跳过 - 某些 formatter（如
prettier）本身不支持增量格式化，强行启用modifications会回退到全文件格式化，反而更慢 - 建议保持默认
file，如真需性能优化，优先考虑关闭editor.formatOnSave，改用保存后手动触发Shift+Alt+F，或绑定快捷键到editor.action.formatDocument
团队协作中格式化规则不一致？用 .editorconfig + .prettierrc 统一源头
VSCode 的设置只是客户端行为，无法保证所有开发者使用相同配置。真正可靠的统一方式，是把规则写进项目配置文件，并让 VSCode 尊重它们。
- 安装
EditorConfig for VS Code插件，它会自动读取项目根目录的.editorconfig（控制缩进、换行符等基础风格） - Prettier 用户务必在项目中放置
.prettierrc（或prettier.config.js），并设置"prettier.requireConfig": true，避免 VSCode 用自己的默认规则覆盖项目约定 - 注意：ESLint + Prettier 混合使用时，不要同时开启
editor.formatOnSave和eslint.formatOnSave，二者冲突；应禁用后者，改用 ESLint 插件的eslint.codeActionsOnSave.mode控制修复时机
实际项目里最常被忽略的是 formatter 的语言绑定粒度和配置文件的加载优先级——不是插件装了就能用，也不是设置了就一定生效。多看一眼状态栏右下角的语言模式标识，再点开它确认默认 formatter 是否正确，比反复重启 VSCode 更有效。
