VSCode怎么自动保存代码

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 也不报错。这时候，与其盯着设置看，不如直接瞥一眼状态栏右下角，如果有 ● 标志，说明文件还没存。