VSCode 切换窗口时自动保存文件靠的是 files.autoSave 设为 "onFocusChange",即编辑器失去焦点时即时保存,仅对已命名文件生效,不支持只读或未保存文件,且与格式化失败、系统焦点事件限制等相关。

VSCode 切换窗口时自动保存文件,靠的是 files.autoSave 配置
VSCode 本身没有“仅在切换窗口时保存”的独立开关,但它的 files.autoSave 支持 onFocusChange 模式——即当前编辑器失去焦点(比如你点到浏览器、终端或另一个 VSCode 窗口)时自动保存。这正是你想要的行为。
常见错误是设成 onWindowChange(已废弃)或误以为要装插件。其实原生支持,只需改一个配置项。
-
files.autoSave必须设为"onFocusChange",不是字符串"onfocuschange"(大小写敏感) - 该行为只对已保存过的文件生效;新建未命名的临时文件(如
Untitled-1)不会自动保存到磁盘 - 如果同时启用了
files.autoSaveDelay,它会被忽略——onFocusChange是即时触发的,不等待延迟
如何正确设置 files.autoSave 为 onFocusChange
直接改用户设置(全局生效)或工作区设置(仅当前项目),推荐优先用用户设置,避免每个项目重复配。
打开设置界面(Ctrl+, 或 Cmd+,),搜索 files.autoSave,下拉选择 onFocusChange;或者手动编辑 settings.json:
{
"files.autoSave": "onFocusChange"
}- 不要加逗号结尾(JSON 格式错误会导致整个设置失效)
- 如果已有其他配置,确保该行不在被注释掉的代码块里(比如被
//或/* */包裹) - 改完不用重启,VSCode 会热重载设置,但需确保当前文件有焦点再切出去才触发第一次验证
为什么有时候切出去没保存?几个关键干扰点
看起来配置对了却没反应,大概率卡在这几个地方:
- 当前文件是只读状态(比如权限不足、文件被其他进程占用),VSCode 会静默失败,不报错也不提示
- 你切的是 VSCode 内部标签页(比如从 A.ts 切到 B.js),这不算「失去焦点」,只有切到外部应用(Chrome、Finder、Terminal)才算
- 开启了
files.autoSave但同时又开了「保存前格式化」(editor.formatOnSave),而格式化失败(比如 Prettier 缺失)会导致保存中止——此时文件不会落盘,也无明显提示 - 某些远程开发场景(SSH / WSL),文件系统延迟或权限模型不同,
onFocusChange可能响应滞后甚至跳过
和 onDelay 或 afterDelay 的本质区别
onFocusChange 不是定时保存,而是监听窗口级焦点事件;而 onDelay(新版叫 afterDelay)是纯时间驱动:只要编辑过,就等 N 毫秒后保存,不管有没有切走。
- 如果你希望“离开前必存”,选
onFocusChange;如果希望“改几秒后就存,不管我还在不在”,选afterDelay -
onFocusChange在多显示器、多工作区、全屏应用切换时表现稳定;afterDelay在快速输入中途可能频繁写盘,影响 SSD 寿命(虽小但真实) - macOS 上部分全屏应用(如 Keynote)切换时可能不触发标准焦点事件,这时
onFocusChange会失效——这是系统限制,非 VSCode bug
真正要注意的,是别把「焦点」理解成「鼠标点击位置」,它指的是操作系统层面的活动窗口归属。这点容易被忽略,但决定了配置到底管不管用。


















