VSCode本地项目自动保存必须用工作区设置，因工作区设置（.vscode/settings.json）优先级高于用户设置，会直接覆盖全局配置；若其中设为"off"，即使全局设为"afterDelay"也无效，且需同步配置files.autoSaveDelay（建议1000～2000毫秒）才能稳定生效。
本地项目自动保存必须用工作区设置，用户级设置会被覆盖，且无法按项目差异化控制。
为什么改了全局设置却对当前项目无效
VS Code 的 files.autoSave 是分层生效的：用户设置（全局）→ 工作区设置（当前文件夹）→ 文件夹设置（多根工作区中的子文件夹）。只要项目根目录下存在 .vscode/settings.json，它就会优先使用其中的 files.autoSave 值，哪怕你全局设成了 afterDelay，项目里写了个 "files.autoSave": "off"，那这个项目就真不会自动保存。
- 检查右下角状态栏：如果显示「工作区」或「文件夹」，说明当前正受项目级配置约束
- 快捷键
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Preferences: Open Workspace Settings (JSON)，直接编辑项目专属配置 - 不要手动在用户
settings.json里写项目相关路径逻辑——VS Code 不支持条件判断式配置
如何为当前项目正确启用 afterDelay 模式
这是最可控、最不易误触发的本地项目自动保存方式。关键不是只设 files.autoSave，而是必须同步配好延迟时间，否则默认 0 毫秒会导致高频刷盘、卡顿甚至保存失败。
- 打开项目根目录下的
.vscode/settings.json（若无则新建） - 写入以下内容（注意逗号和引号格式）：
{ "files.autoSave": "afterDelay", "files.autoSaveDelay": 1500 } -
files.autoSaveDelay单位是毫秒，建议设为1000～2000；低于500容易因快速输入被中断，高于3000则感知滞后 - 无需重启 VS Code，保存该文件后立即生效
onFocusChange 在项目中容易出什么问题
虽然对新手友好，但在本地项目中启用 onFocusChange 可能引发意外行为，尤其当你频繁切换终端、浏览器或调试面板时。
- 焦点移出编辑器（比如点一下终端）→ 当前文件立刻保存 → 若此时 ESLint/Prettier 正在格式化且失败，VS Code 会回滚保存动作，看起来像“没保存”
- 多个标签页间切换（如
index.js→style.css）→ 前者保存，后者也保存，但若后者有语法错误，可能连带阻塞前者 - Git 相关操作（如点击 Source Control 视图）也会触发焦点离开，导致未完成的草稿提前落盘
- 如果你同时启用了
editor.formatOnSave，建议搭配editor.codeActionsOnSave而非依赖焦点变化来触发
文件被排除导致自动保存静默失效
VS Code 不会对匹配 files.exclude 或 files.watcherExclude 的路径执行自动保存逻辑，这在大型项目中极易被忽略。
- 检查项目级
.vscode/settings.json中是否误加了类似"**/dist/**": true或"node_modules/**": true的排除项 - 特别注意：某些脚手架（如 Vue CLI、Create React App）生成的模板会默认把
build/、out/加入排除，若你在这些目录下临时编辑文件，自动保存会完全不响应 - 验证方法：打开一个被排除路径下的文件，修改后等待 2 秒，看右上角是否出现「已修改」星号 —— 如果没有，大概率是被排除了
真正麻烦的不是设不设自动保存，而是设完之后不知道它在哪一层被悄悄关掉了。每次遇到“明明设置了却不生效”，第一反应不该是重装插件，而是先看右下角状态栏、再查 .vscode/settings.json、最后翻 files.exclude。这三个地方卡住任何一个，自动保存就形同虚设。
