VSCode默认不自动保存，必须将files.autoSave设为"afterDelay"、"onFocusChange"或"onWindowChange"之一，且需排除工作区覆盖、语言专属配置、插件拦截、未设延迟参数或文件未处于“已修改”状态等常见失效原因。

VSCode 默认不自动保存，所谓“开启自动保存”本质是配置 files.autoSave 为合法值，并排除常见覆盖与拦截条件——设成 true、1 或只改 UI 下拉菜单却不配延迟参数，都会导致看似开启实则无效。

为什么改了 files.autoSave 却没反应

不是功能坏了，而是配置被更高优先级规则屏蔽或触发条件未满足：

• 工作区设置（.vscode/settings.json）会直接覆盖用户级设置；右下角显示「工作区」时，必须检查该文件里是否写了 "files.autoSave": "off"
• 语言专属配置可单独关掉某类文件：比如你为 markdown 设过 "files.autoSave": "off"，那所有 .md 文件就永远不自动存，和其他文件无关
• 插件在保存前执行操作（如 editor.codeActionsOnSave 或 editor.formatOnSave）失败时，VSCode 会静默中止整个保存流程——打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），看 Console 是否有 Failed to save 或 No formatter registered 报错
• files.autoSave 对新建的 Untitled-1 标签页完全无效；必须先 File > Save As 指定路径，生成真实文件名和磁盘位置后，自动保存才开始起作用

files.autoSave 只接受四个字符串值，不是开关

它不是布尔型配置，任何非字符串值（如 true、false、1、0）都会被忽略，等同于没配：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• "off"：完全禁用（VSCode 默认值）
• "afterDelay"：必须同步配置 files.autoSaveDelay（单位毫秒），否则默认延迟可能不触发保存；推荐值 800～1500
• "onFocusChange"：当前编辑器标签页失去焦点即保存（切到终端、点资源管理器、换另一个文件都算）
• "onWindowChange"：整个 VSCode 窗口失焦才保存（Alt+Tab 切走、系统通知弹窗、微信浮窗盖住都会触发，不稳定，不推荐）

如何配 afterDelay 让延时保存真正可用

这是最常用也最容易踩坑的模式，关键不在“设了”，而在“设对”：

• 必须同时设置 files.autoSaveDelay，例如：

  { "files.autoSave": "afterDelay", "files.autoSaveDelay": 1000 }

• 设太小（如 100）在 WSL 或机械硬盘上能感知卡顿；设太大（如 3000）容易改完就切走，内容仍滞留在内存里
• 注意路径排除：files.autoSaveExclude 不是自动生效的，需手动加，例如前端项目应写：

  "files.autoSaveExclude": ["**/dist/**", "**/build/**"]

  ，否则每次保存都触发 Webpack 重编译
• 多根工作区建议把 files.autoSave 和 files.autoSaveExclude 写在工作区 .vscode/settings.json 里，避免污染全局

按语言类型差异化控制自动保存

不是所有文件都适合自动保存。调试用的 .log、临时脚本、.env，你可能希望它们永远不自动落盘；而 .ts 或 .py 文件则照常延时保存：

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入并选择 Preferences: Configure Language Specific Settings
• 选中目标语言（如 Log 或 Shell Script），在弹出的 JSON 片段中添加：

  "files.autoSave": "off"

• 注意语法：语言 ID 必须准确，比如 Markdown 是 markdown，不是 md；Python 是 python，不是 py

真正容易被忽略的是：自动保存只响应“已修改且已落地”的文件——新建空文件、刚从 Git 拉下来未改动的文件，右上角没有圆点（●），就不会触发任何保存逻辑。别只盯着设置是否勾选，先确认那个文件是不是真处于“已修改”状态。