自动保存开关在 settings.json 中配置 files.autosave；支持 "off"、"afterdelay"（需配 files.autosavedelay）、"onfocuschange"、"onwindowchange" 四种模式，多根工作区和远程开发时建议手动编辑工作区 settings.json。
自动保存开关在哪：settings.json 里改 files.autoSave
VSCode 的自动保存不是靠点几下图形界面就能彻底生效的，关键得改配置项 files.autoSave。图形设置里搜“auto save”能调出开关，但那只是快捷入口，背后实际写入的是 settings.json。如果你用的是多根工作区或远程开发（比如 SSH 或 WSL），图形界面改的可能是用户级设置，而项目需要工作区级覆盖——这时候手动编辑 settings.json 更可靠。
常见错误现象：files.autoSave 设成 "afterDelay" 却没反应，其实是没配 files.autoSaveDelay；或者设成 "onFocusChange"，结果切到终端就保存，但你只想在切文件时保存——这说明对触发时机理解有偏差。
-
"off"：完全关闭，适合调试或编辑敏感配置文件时手动控制 -
"afterDelay"：延迟保存，必须同时设files.autoSaveDelay（单位毫秒，默认 1000），太小易卡顿，太大失去意义 -
"onFocusChange"：当前编辑器失去焦点时保存，包括切到另一个标签、终端、甚至点击侧边栏 -
"onWindowChange"：整个 VSCode 窗口失焦才保存（比如 Alt+Tab 切到浏览器），适合多任务但怕误存的场景
哪些文件不该自动保存：用 files.autoSaveExclude 排除干扰
不是所有文件都适合自动保存。比如生成的 dist/ 目录、打包产物 bundle.js、或是本地 mock 数据 mock-data.json，频繁保存可能触发构建工具重复编译，或让 Git 脏提交变多。VSCode 不会智能识别这些，得靠 files.autoSaveExclude 显式排除。
使用场景：前端项目里改个 src/ 下的组件，不希望每次保存都顺手把 public/ 里的静态资源也刷一遍；或者 Python 项目中编辑 .py 文件，但不想连自动生成的 __pycache__/ 也参与保存逻辑。
- 路径支持 glob 模式，例如
"**/dist/**"、"**/*.log" - 注意斜杠方向：Windows 下也统一用
/，不是\ - 如果用了多工作区，这个配置建议放在工作区
.vscode/settings.json里，避免影响其他项目
和 ESLint / Prettier 冲突？保存时格式化优先级决定行为
很多人开了 editor.formatOnSave，又设了 files.autoSave: "afterDelay"，结果发现代码格式化总“慢半拍”——不是没生效，而是格式化发生在保存之后，而自动保存又立刻把未格式化的版本写进磁盘。本质是执行顺序问题：VSCode 默认先保存，再触发格式化；但如果你希望“格式化完再保存”，就得关掉 editor.formatOnSave，改用 editor.codeActionsOnSave 配合 source.formatDocument。
性能影响：开启 editor.formatOnSave + 自动保存后，每次延迟保存都会多一次格式化调用，对大文件（如 5MB+ 的 JSON）可能明显卡顿；而用 codeActionsOnSave 可以更精细地控制只在特定语言启用。
- 推荐组合：
"files.autoSave": "onFocusChange"+"editor.codeActionsOnSave": { "source.formatDocument": true } - 避免组合：
"files.autoSave": "afterDelay"+"editor.formatOnSave": true（容易出现“保存了但没格式化”或“格式化了但又被覆盖”的错觉） - 检查是否被插件覆盖：某些 Prettier 插件会强行接管保存逻辑，此时看右下角状态栏的“Prettier”图标是否亮起，亮着就说明它在主导流程
远程开发（SSH/WSL）下自动保存失效的典型原因
在 WSL 或远程 SSH 连接里，files.autoSave 看似开着，但文件就是不自动写入磁盘——大概率是文件系统事件监听失败。VSCode Remote 依赖 fs.watch 类机制监听变更，而某些 WSL 版本或挂载方式（如 /mnt/c）对 inotify 支持不完整，导致“延迟保存”根本收不到触发信号。
兼容性影响：WSL2 默认比 WSL1 支持更好，但若项目路径在 Windows 文件系统（/mnt/c/Users/xxx/project），依然可能掉链子；换成 WSL 原生路径（/home/xxx/project）通常能解决。
- 验证方法：打开命令面板（Ctrl+Shift+P），运行
Developer: Toggle Developer Tools，切到 Console 标签，保存时看有没有ENOSPC或inotify watch limit reached报错 - 临时修复：在 WSL 中执行
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p - 更稳方案：直接用
"files.autoSave": "onFocusChange"，它不依赖文件系统事件，靠编辑器焦点变化驱动，兼容性高得多
自动保存看着简单，但真正用顺的关键不在开不开，而在清楚每种模式的触发边界和副作用。特别是多人协作项目里，有人用延迟保存，有人用失焦保存，再配上不同格式化策略，一个 git status 就能看出谁没对齐配置。
