VSCode 默认不自动保存代码，这事儿其实挺多新手踩过坑。看着好像设置里“自动保存”已经打开了，但一转头发现文件还是没存上，最后还得靠手动 Ctrl+S。问题出在哪？关键就在于，这个功能不是开关那么简单。
files.autoSa ve 只能设这四个值，别拿布尔值去填
首先得搞清楚一个很常见的误解：files.autoSa ve 这个配置，不是 true 或 false 就能打发的。它真正能接受的只有下面这四挡：
off：彻底关闭，这是默认值afterDelay：编辑停止后延迟保存。选了它，就必须再设置files.autoSa veDelay（单位毫秒），不然默认是0，那样就会高频刷盘，反而可能拖慢编辑器onFocusChange：当前编辑器失去焦点时立即保存。比如你从代码窗口点到了终端、切到另一个标签页、或点一下侧边栏，文件就会自动保存onWindowChange：整个 VSCode 窗口失焦才保存。这意味着你Alt+Tab切出去、或者微信弹窗盖住了窗口，都会触发保存。这种模式容易误存，要小心
在图形界面上搜 “auto sa ve”，下拉选一个，本质上就是在往 settings.json 里写这个字段。别只选完就走了，特别是选了 afterDelay 时，别忘了去补上 files.autoSa veDelay。
为什么改了设置却没反应？90% 是被覆盖了
不是配置本身无效，而是有更高优先级的规则把它盖掉了。最常见的情况包括：
- 当前项目里有
.vscode/settings.json，里面写了个"files.autoSa ve": "off"。工作区设置的优先级是高于用户设置的，所以就算你在全局改了，也会被项目级的设置压回去 - 某个语言专属配置把它关掉了。比如
"[markdown]": { "files.autoSa ve": "off" }，就会导致所有.md文件无视你的全局规则 - 格式化插件（比如 Prettier、ESLint）开了
editor.formatOnSa ve。但如果格式化失败了——比如缺配置、语法错误、或者插件没激活——VSCode 会静默放弃本次保存，不会报错 - 文件路径被
files.watcherExclude或files.exclude匹配到了。比如你把**/dist/**排除掉了，VSCode 可能就会跳过自动保存逻辑
运行代码前想自动保存？files.autoSa ve 没用
这是另一个容易混淆的点。files.autoSa ve 完全不会响应“运行”这个动作。无论你按 Ctrl+F5、右键点 Run Code，还是点调试按钮，它都只盯着编辑状态或焦点变化，不监听运行命令。
真正能绑定“运行前保存”的，只有 code-runner.sa veFileBeforeRun 这个设置。它只对 formulahendry.code-runner 这个插件生效：
- 在
.vscode/settings.json里加一行："code-runner.sa veFileBeforeRun": true - 这样，每次执行
code-runner.run（快捷键是Ctrl+Alt+N）前，它会强制调用一次保存 - 注意：它对
launch.json调试、自定义tasks.json或 shell 脚本都没用
远程开发（WSL / SSH）下的实际表现
自动保存的逻辑在远程开发里也会正常运行，但 IO 延迟和焦点定义会有变化：
afterDelay的实际延迟可能比设定的值高 200–500ms，尤其是项目路径在/mnt/c/（Windows 文件系统挂载点）的时候- 建议把项目搬到 WSL 的原生路径下，比如
~/project，能避免频繁卡顿 onFocusChange在远程场景下仍然可靠，因为焦点变化是 VSCode 客户端本地判断的，不依赖远端响应
最容易忽略的一点：未命名文件（比如 Untitled-1）或只读文件（权限不足、或被其他进程占用）根本不会触发任何模式的自动保存，而且 VSCode 也不报错。这时候，与其盯着设置看，不如直接瞥一眼状态栏右下角，如果有 ● 标志，说明文件还没存。
