VSCode的files.autoSave必须正确配置模式与延迟：推荐afterDelay设为2000～2500毫秒，避免onFocusChange在多屏/切换应用时失灵；off模式需配合hotExit和restoreWindows防丢；它仅控制写盘时机，与格式化、Lint等动作解耦。
VSCode 的 files.autoSave 看似只是个开关，但选错模式或配错延迟，轻则写半截代码被存进 Git、重则格式化失败+Lint 报错全屏炸开。它不负责修复、不触发 lint、也不管你有没有装 Prettier——它只干一件事：把编辑器里的内容写进磁盘。写早了、写多了、写错了时机，就是所有后续问题的起点。
onFocusChange 模式在多显示器或切微信时会误判焦点
这个模式本意是“离开当前文件就保存”，但 VSCode 1.85+ 引入的 onWindowChange 和它行为接近，而 onFocusChange 实际上依赖操作系统级焦点事件，在以下场景容易失灵：
- 使用双显示器，鼠标移到副屏浏览器/微信窗口，VSCode 编辑器并未真正“失去焦点”，但部分系统会误报 → 文件没保存，崩溃即丢内容
- 用 Alt+Tab 切换应用时，焦点短暂落在任务栏或 Dock 上，VSCode 捕获不到稳定状态 → 延迟写入或完全跳过
- 配合 WSL 或远程 SSH 连接时，终端焦点切换逻辑更复杂，
onFocusChange触发不可靠
实操建议：除非你明确知道自己的工作流全是单窗口+单显示器+纯键盘操作，否则别默认选它；更稳的选择是 afterDelay，并设为 2000（2秒）而非默认 1000。
afterDelay 设太短会导致未完成代码被提交到 Git
很多人设成 300 或 500 毫秒，以为“越快越安全”。结果是：
- 刚敲完
if (就停顿半秒，文件已写入磁盘 → Git diff 出现大量临时括号、未闭合引号、半截变量名 - ESLint 在保存瞬间读取脏文件，报出一堆
Unexpected token错误，干扰真实问题定位 - 配合
editor.codeActionsOnSave时，source.fixAll.eslint可能尝试修复语法错误，反而让编辑器卡住或抛出Cannot read property 'range' of null
实操建议：设为 2000～2500 是平衡点。人脑从输入→暂停→思考→再输入的自然节奏通常在 1.5 秒以上，这个延迟既防丢，又不会吞掉你的草稿。
off 模式下不等于“绝对安全”，必须配 hotExit + restoreWindows
设 files.autoSave: "off" 后，你以为 Ctrl+S 才落地？其实还有两个隐藏风险点：
- VSCode 崩溃或系统断电时，未保存内容直接消失——除非你开了
files.hotExit: "on" - 重启后窗口没恢复、文件标签页丢失——需要同时启用
window.restoreWindows: "all" - 某些插件（如 GitLens、TODO Tree）依赖文件已写入磁盘才能索引，
off模式下它们可能无法实时响应
实操建议：如果真要用 off（比如编辑密钥文件），务必在 .vscode/settings.json 里补上：
"files.hotExit": "on", "window.restoreWindows": "all"
否则，“手动保存”只是把风险从“误存”转移到“必丢”。
自动保存和 editor.codeActionsOnSave 不是绑定关系
这是最常被误解的一点：files.autoSave 控制“什么时候写磁盘”，editor.codeActionsOnSave 控制“写磁盘时要不要触发修复动作”，二者完全解耦。常见错误包括：
- 开了
files.autoSave: "afterDelay"，但没配editor.codeActionsOnSave→ 文件自动存了，ESLint/Prettier 一个都不动 - 关了
files.autoSave，却指望editor.formatOnSave: true能起作用 → 它只在你按 Ctrl+S 时生效，而off模式下你根本不会按 - 同时开启
editor.formatOnSave和editor.codeActionsOnSave中的source.formatDocument→ Prettier 被调两次，缩进变 4 空格又变回 2，光标乱跳
实操建议：统一走 editor.codeActionsOnSave 路线，显式关闭 editor.formatOnSave，并确保 editor.defaultFormatter 已设为 "esbenp.prettier-vscode" 或对应语言 formatter。
真正麻烦的从来不是“怎么开自动保存”，而是“它在什么条件下写、写的是不是我想要的那一刻的状态”。哪怕只差 300 毫秒，也可能让一次重构变成 Git 冲突现场。配置不是越激进越安全，而是越贴合你真实敲代码的呼吸节奏，才越可靠。
