多根工作区自动保存必须配置在工作区根目录的.vscode/settings.json中,全局或.code-workspace设置无效;files.autoSave仅支持"off"、"afterDelay"、"onFocusChange"、"onWindowChange"四种字符串值,设为true或1会被静默丢弃。

多根工作区里自动保存必须配在工作区 settings.json 里
全局设置不管用。你改了用户级 settings.json 里的 files.autoSave,但打开多根工作区后右下角显示「工作区」,说明当前生效的是项目级配置——它会直接忽略你的全局设置。
正确做法是:确保工作区根目录下有 .vscode/settings.json,里面写明 files.autoSave 和配套项。例如:
{
"files.autoSave": "afterDelay",
"files.autoSaveDelay": 1200,
"files.autoSaveExclude": ["**/dist/**", "**/build/**", "**/__pycache__/**"]
}
注意三点:
-
files.autoSave只能是字符串:"off"、"afterDelay"、"onFocusChange"或"onWindowChange";设成true或1会被静默丢弃 - 选
"afterDelay"必须同步配files.autoSaveDelay(单位毫秒),不配就等同于"off" - 多根工作区中,这个文件要放在工作区根目录(即和
.code-workspace同级的.vscode文件夹里),不是某个子项目的.vscode
为什么 onFocusChange 在多根工作区里反而容易漏存
它监听的是“当前编辑器标签页是否失去焦点”,而不是“是否切换到其他项目”。所以当你在 frontend 里写代码,点一下 backend 的文件树或终端,frontend 文件立刻保存——这没问题;但如果你只是点了侧边栏的「源代码管理」,再点回同一个项目的另一个 .ts 文件,焦点其实没离开当前项目上下文,onFocusChange 不触发,文件仍带 ● 圆点。
更隐蔽的问题是:VS Code 多根工作区对「焦点」的判定依赖窗口层级,远程开发(如 WSL)或 macOS 上某些浮窗(微信、通知中心)可能让焦点行为不稳定。
建议场景:
- 临时查文档、切终端频率高 → 用
"onFocusChange",防丢内容 - 连续编码、频繁修改多个文件 → 改用
"afterDelay"(1000~1500 毫秒),避免高频刷盘 - 完全不想自动存(比如改
.env或调试配置)→ 单独加语言专属配置,例如在settings.json里嵌套"[shellscript]": { "files.autoSave": "off" }
.code-workspace 文件里不能写 files.autoSave 配置
.code-workspace 是定义“有哪些文件夹”的元数据文件,不是运行时配置载体。它的 settings 字段只接受部分白名单项(如 files.exclude、search.exclude),而 files.autoSave 不在其中——你硬写进去,VS Code 启动时会忽略它,且不报错。
常见误操作:
- 以为在
.code-workspace的settings里写了"files.autoSave": "afterDelay"就生效了 → 实际无效 - 把
.vscode/settings.json错放到某个子项目文件夹里 → 多根模式下该配置默认不加载 - 路径写错:比如工作区根是
/home/user/myapp,但.vscode/settings.json放在了/home/user/myapp/frontend/.vscode/→ VS Code 找不到,回落到用户级设置
自动保存 + 格式化插件容易互相卡住
开了 editor.formatOnSave 又配了 files.autoSave: "afterDelay",结果代码改完 1.2 秒后自动保存,但格式化插件还没跑完,或者格式化失败(比如 Prettier 缺 .prettierrc),VS Code 会静默取消本次保存——看起来就像“没存”。
排查顺序很关键:
- 先关掉
editor.formatOnSave,测试files.autoSave是否真生效(看右上角 ● 是否消失) - 再单独测试格式化:手动按
Ctrl+S,看有没有弹错误提示,或输出面板里Prettier/ESLint日志是否报错 - 确认格式化插件已激活:比如 TypeScript 项目要装
esbenp.prettier-vscode或官方ms-vscode.vscode-typescript-next,Python 项目得配对ms-python.python
真正容易被忽略的是:自动保存只对“已修改且未保存”的文件起作用。新建一个空 .js 文件,没输任何字符,右上角没 ●,此时无论怎么切焦点或等延迟,都不会触发保存——它根本不在自动保存的触发范围内。











