VS Code自动保存与格式化需协同配置：必须启用自动保存（推荐onFocusChange或onWindowChange模式），且formatOnSave生效需满足三条件——有可用格式化工具、配置为true且未被排除；同时需对齐Prettier与ESLint规则，避免冲突，并验证格式化提供程序是否正确绑定及配置文件是否存在。
VS Code 的自动保存和格式化不是“开个开关”就能完美协同的，关键在触发时机和执行顺序的配合——默认情况下，保存时格式化可能被跳过，或格式化后文件又因保存策略被二次写入。
自动保存必须显式启用且选对模式
VS Code 默认关闭自动保存，仅靠格式化配置无法触发保存行为。需手动开启并避免使用 afterDelay 模式（它依赖计时器，容易漏掉快速编辑后的保存）：
-
"files.autoSave": "onFocusChange"—— 切出编辑器时保存，适合多文件频繁切换场景 -
"files.autoSave": "onWindowChange"—— 切换到其他应用时保存，防丢稿最稳妥 -
"files.autoSave": "afterDelay"—— 不推荐，延迟期间若手动 Ctrl+S，可能造成格式化与保存不同步
保存时格式化需同时满足三个条件
仅设置 "editor.formatOnSave": true 不够。VS Code 会在以下三者全部就位时才执行格式化：
- 当前文件有对应语言的可用格式化工具（如
prettier、eslint --fix、python-black），且已通过插件安装并注册 -
"editor.formatOnSave"为true，且未被工作区或文件夹级设置覆盖 - 该语言未被
"editor.formatOnSaveExclude"或"[javascript]": { "editor.formatOnSave": false }显式禁用
常见错误：装了 Prettier 插件但没在命令面板运行 Developer: Toggle Developer Tools 查看控制台，结果发现格式化提供程序未激活，导致保存时静默跳过。
避免格式化与 ESLint/TS 等修复冲突
当同时启用 editor.formatOnSave 和 eslint.enable + eslint.autoFixOnSave（已弃用）或 editor.codeActionsOnSave 时，执行顺序不明确，可能相互覆盖：
- 优先用
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }替代旧版 autoFix 配置 - 若格式化（如 Prettier）和 ESLint 规则冲突，应在
.prettierrc和.eslintrc.cjs中对齐规则，或用eslint-config-prettier关闭 ESLint 的格式化类规则 - 不要同时开启
editor.formatOnSave和editor.formatOnType处理同一类文件，尤其对 JSX/TSX，易引发光标跳动或重复缩进
格式化实际生效前可加轻量验证
保存后没反应？别急着改配置，先验证格式化是否真能运行：
- 打开命令面板（
Ctrl+Shift+P），输入Format Document手动执行一次，看是否有报错 - 检查状态栏右下角语言标识（如
JavaScript），点击它确认当前语言模式正确，否则格式化提供程序不会加载 - 在设置中搜索
default formatter，展开Editor: Default Formatter，确认对应语言已绑定具体插件（如esbenp.prettier-vscode）
最常被忽略的是：项目根目录缺少 .editorconfig 或 .prettierrc，导致 VS Code 退回到默认空格式化逻辑，看似“没效果”，实则是没触发任何真实格式化动作。
