VSCode默认不自动保存，需配置files.autoSave为afterDelay（编辑停止后延迟保存，需设files.autoSaveDelay）或onFocusChange（编辑器失焦时立即保存），注意工作区设置、格式化插件失败及文件权限等干扰项会导致“设了却未生效”。
VSCode 默认不自动保存，所谓“开启自动保存”本质是选对 files.autoSave 的值并避开常见干扰项；定时保存（afterDelay）和焦点切换保存（onFocusChange）行为差异极大，混用或配错会导致“明明设了却没存”的假失效。
为什么 afterDelay 模式下改完代码没立刻保存？
它不是“每 X 秒保存一次”，而是“编辑停止后等待 X 毫秒再保存”——每次按键都会重置倒计时。这意味着：
- 你连续敲 3 秒代码，它根本不会触发保存
- 你改完一行停顿 1.2 秒（默认
files.autoSaveDelay是 1000），它立刻落盘，哪怕你正卡在 Git 冲突标记中间 -
files.autoSaveDelay单位是毫秒，设成5000比1000更稳妥，避免误触 - 该模式对格式化插件（如 Prettier）极其敏感：若
editor.formatOnSave开启且格式化失败（比如语法错误、插件未安装），保存会被静默中止，文件仍为 dirty 状态
onFocusChange 看起来没反应？先检查这三件事
这个模式监听的是“编辑器焦点变化”，不是“窗口是否最小化”或“你有没有 Alt+Tab”。常见失效原因根本不是配置错，而是：
- 当前文件是未命名的
Untitled-1—— 它只对已保存、有路径的文件生效 - 你只是在 VSCode 内部切 Tab（比如从
a.ts点到b.js），这不算“失去焦点”，必须切到终端、浏览器、Finder 等外部应用才触发 - 文件被设为只读（权限不足 / 被其他进程占用），VSCode 不报错也不提示，保存直接失败
注意：onFocusChange 是即时触发，files.autoSaveDelay 对它完全无效，设了也白设。
工作区设置会悄悄覆盖全局配置
你在一个项目里调好了 files.autoSave，换个项目发现又得重设？大概率是那个项目根目录下的 .vscode/settings.json 里写了：
{ "files.autoSave": "off" }
这个设置优先级高于用户级配置，且不会在 UI 设置界面里高亮提醒。排查方法：
- 打开命令面板（
Ctrl+Shift+P），运行Preferences: Open Workspace Settings (JSON) - 搜索
"files.autoSave"，确认没被注释掉也没拼错（比如写成"onfocuschange"就无效，必须小写onFocusChange） - 如果想全局统一，就别在工作区里配，直接改用户 settings.json 或 UI 设置
格式化插件才是最常背锅的“自动保存杀手”
即使 files.autoSave 设对了，editor.formatOnSave 或 eslint.enable + eslint.autoFixOnSave（旧版）也可能拦住保存流程。表现是：切走再切回来，文件右上角仍有圆点（dirty 状态），但无任何错误提示。
验证方式很简单：
- 临时禁用 Prettier / ESLint 插件，再试一次
onFocusChange - 或在设置里关掉
editor.formatOnSave，改用手动格式化（Shift+Alt+F） - 远程开发（WSL/SSH）场景下，格式化延迟更高，更容易超时失败
真正容易被忽略的点：VSCode 的保存是原子操作，格式化失败 → 保存中止 → 文件不落盘 → 你毫无感知。这不是配置问题，是流程阻断，得从扩展行为本身入手。
