VSCode全局自动保存必须设为off、afterDelay、onFocusChange或onWindowChange之一;非法值如true等直接失效等同off,且受项目级、语言级配置及插件行为覆盖。

VSCode 全局自动保存必须设为字符串值 off、afterDelay、onFocusChange 或 onWindowChange 之一;填 true、1、"true" 等非法值会直接失效,等同于 off。
files.autoSave 只能是这四个字符串值
它不是布尔开关,也不是数字延迟配置项——files.autoSave 是一个严格枚举字段。图形界面里选“自动保存”下拉菜单,本质就是在用户 settings.json 里写入其中一项:
-
off:彻底关闭(默认值) -
afterDelay:编辑停止后延时保存 —— 必须同步配files.autoSaveDelay(单位毫秒),否则延迟为 0,可能高频刷盘甚至卡顿 -
onFocusChange:当前编辑器标签页失去焦点即保存(切终端、点侧边栏、换文件标签都会触发) -
onWindowChange:整个 VS Code 窗口失焦才保存(Alt+Tab 切出、微信浮窗盖住也会触发,不稳定)
为什么改了全局设置却没生效
90% 的“没反应”不是配置错了,而是被更高优先级规则覆盖或拦截:
- 检查项目根目录是否存在
.vscode/settings.json,里面若有"files.autoSave": "off",它会直接屏蔽全局设置 - 语言专属配置可能单独关掉某类文件,例如
"[markdown]": { "files.autoSave": "off" }会让所有.md文件无视全局规则 - 格式化插件(如 Prettier/ESLint)开启
editor.formatOnSave后,若格式化失败(缺配置、语法错、插件未激活),VS Code 会静默放弃本次保存 - 文件路径匹配了
files.watcherExclude或files.exclude(如"**/dist/**"),VS Code 可能跳过自动保存逻辑
afterDelay 模式必须配 files.autoSaveDelay
只设 "files.autoSave": "afterDelay" 而不设 files.autoSaveDelay,VS Code 会用 0 毫秒延迟,导致每敲一个字符都尝试保存,尤其在 WSL 或远程开发中极易卡顿:
- 推荐值:800~1500(单位毫秒),例如
"files.autoSaveDelay": 1000 -
files.autoSaveDelay对onFocusChange和onWindowChange完全无效,留着也无害,但别指望它起作用 - WSL/SSH 场景下,实际延迟可能比设定值高 200–500ms,别设太激进(比如 300)
运行前自动保存?files.autoSave 不管用
files.autoSave 完全不响应“运行”动作 —— 无论你按 Ctrl+F5、右键 Run Code 还是点调试按钮,它只监听编辑状态或焦点变化:
- 真正绑定“运行前保存”的,只有
code-runner.saveFileBeforeRun(仅对formulahendry.code-runner插件生效) - 需手动加到 settings.json:
"code-runner.saveFileBeforeRun": true - 对
launch.json调试、自定义tasks.json或 shell 脚本无效
最容易被忽略的是:新建的 Untitled-1、没有真实路径的文件、只读文件、Git 合并冲突标记行(如 ),这些根本不会触发任何自动保存逻辑 —— 它只对「有路径且处于修改状态(右上角带 ●)」的文件生效。


















