files.autoSave必须开启才能触发formatOnSave,推荐onFocusChange模式;设afterDelay需同步配files.autoSaveDelay(建议1500–2500ms);注意作用域、语言专属覆盖及排除生成文件。

好用,但不是“开了就完事”——开错模式、配错时机、没协同其他设置,反而会丢内容、卡编辑、提交半截代码。
files.autoSave 选哪个值才不翻车
别信默认的 afterDelay。它靠计时器,你改两行、切去终端查日志、再切回来,1 秒延迟根本没触发,文件右上角还带星号,Git diff 却是空的。
-
onFocusChange:最贴近直觉。点另一个文件标签、点侧边栏、甚至点终端,当前编辑器立刻保存。适合单项目专注开发 -
onWindowChange:整个 VS Code 窗口失焦才保存(比如 Alt+Tab 切到浏览器)。适合多任务,但微信弹窗、系统通知都可能让它误判 -
afterDelay:只在你需要防抖时用(比如写 Markdown 或配置文件),files.autoSaveDelay设 1500–2500 毫秒较稳;低于 800 容易高频刷盘,尤其 WSL 或远程开发时明显卡顿 -
off:仅建议临时用于.env、docker-compose.yml等敏感文件,且必须配files.hotExit和files.restoreWindows兜底
为什么改了 files.autoSave 还没反应
常见失效原因不是配置错,而是作用域或依赖项没对齐。
- 你在图形界面改的,实际写入的是用户级
settings.json;但项目用了多根工作区或远程开发(如 SSH/WSL),得手动改工作区下的.vscode/settings.json - 设了
afterDelay却没配files.autoSaveDelay→ 直接退化成off,VS Code 不报错也不提醒 - 语言专属设置覆盖了全局:比如
"[javascript]": { "files.autoSave": "off" },那 JS 文件永远不自动保存 - 某些插件(如 Tailwind CSS IntelliSense、ESLint 自动修复)会在保存瞬间注入逻辑,若格式化失败,VS Code 可能中断写盘,文件持续显示星号却没落磁盘
editor.formatOnSave 和 files.autoSave 能不能一起开
能,但顺序不对就会“代码跳”“光标乱跑”“缩进错乱”。VS Code 默认先保存原始内容,再格式化——你看到的其实是“保存后又被重排”的结果。
- 想让格式化优先?关掉
editor.formatOnSave,改用editor.codeActionsOnSave配合语言扩展,例如:"editor.codeActionsOnSave": { "source.organizeImports": true, "source.fixAll.eslint": true } - 同时开了
editor.formatOnSave和source.formatDocument(比如 Prettier)→ 同一个文件被调两次格式化,大概率出问题 - 大文件(>2MB)+ Prettier + ESLint 共存时,保存延迟可能超 1 秒,期间你继续敲字,光标位置会因重排丢失
哪些文件该排除自动保存
不是所有修改都该立刻落盘。生成文件、日志、本地 mock 数据频繁保存,会白触发构建、污染 Git、拖慢体验。
- 用
files.autoSaveExclude显式排除,支持 glob:"**/dist/**"、"**/*.log"、"**/mock-data.json" - 路径统一用
/,Windows 下也别写\ - 这个配置建议放在工作区
.vscode/settings.json里,避免影响其他项目 - 注意:VS Code 不识别
node_modules/或__pycache__/是否为生成目录,得你手动加排除,否则每次yarn install后打开文件可能触发无意义保存
真正容易被忽略的,是自动保存和崩溃恢复的分工:files.autoSave 只管“你正在编辑时把内容写进磁盘”,而 files.hotExit 和 files.restoreWindows 才决定 VS Code 崩溃或断电后能不能找回那些“已改未存”的状态——两者缺一不可。











