VSCode没有“每X秒自动保存”功能，files.autoSaveDelay是停止输入后的防抖阈值而非定时器；最常见失效原因是未先将files.autoSave设为"afterDelay"字符串值，该延迟仅在此模式下生效，且必须为整数毫秒值。
VSCode 没有“每 X 秒自动保存一次”的配置项，files.autoSaveDelay 不是定时器周期，而是用户停止输入后的等待阈值；手动触发保存的快捷键始终有效，且比自动保存更可靠。
为什么设了 files.autoSaveDelay 却不生效
最常见原因是没先启用 afterDelay 模式：files.autoSaveDelay 仅在 files.autoSave 设为 "afterDelay" 时才起作用。设成 "off" 或 "onFocusChange" 后，该延迟值完全被忽略。
-
files.autoSave必须显式设为"afterDelay"（字符串值，区分大小写） - 最小合法值为
100，设0或负数会被重置为默认1000 - 延迟只对当前编辑的文件生效；切标签页或失焦会立刻保存，不等倒计时结束
- 修改后无需重启，但需确保未被工作区
.vscode/settings.json覆盖
onFocusChange 和 onWindowChange 的实际触发边界
这两个模式看似“即时”，但触发条件有明确差异，容易误判：
-
onFocusChange：焦点离开**当前编辑器标签页**即触发，比如 Ctrl+Tab 切到另一个打开的文件、点侧边栏、甚至点终端面板——都会保存当前文件 -
onWindowChange：只有整个 VSCode 窗口失去系统级焦点才触发，比如 Alt+Tab 切到浏览器、微信或桌面，但切换到同 VSCode 实例的另一个窗口不算 - 若同时打开多个 VSCode 窗口，
onWindowChange不会跨窗口同步保存，只响应本窗口失焦 - 两者都不依赖
files.autoSaveDelay，设了也无效
手动保存快捷键与自动保存共存时的行为
即使启用了自动保存，Ctrl+S（Windows/Linux）或 Cmd+S（macOS）仍会立即强制保存当前文件，且会触发关联动作（如 formatOnSave）。
-
Ctrl+K S/Cmd+K S保存所有已修改文件，不受自动保存模式限制 - 若同时启用 Prettier 等格式化插件，
formatOnSave只在真正发生保存动作时执行，包括自动和手动触发 - 频繁按
Ctrl+S不会导致重复写入，VSCode 会跳过无变更的保存请求 - 注意：某些键盘映射插件可能劫持
Ctrl+S，建议检查keybindings.json中是否有冲突规则
用 settings.json 直接写配置的注意事项
直接编辑 JSON 配置比 UI 设置更可控，尤其适合团队统一或版本管理，但有几个硬性约束必须遵守：
-
"files.autoSave": "afterDelay"必须是字符串，不能写成true或1 -
"files.autoSaveDelay"是数字，单位毫秒，不加引号；设为"800"（字符串）会导致静默失效 - 工作区设置（
.vscode/settings.json）优先级高于用户设置，覆盖时不会报错，需主动对比 - 如果项目里启用了
editor.formatOnSave，自动保存会连带触发格式化——这可能延长实际写入耗时，尤其大文件
真正影响保存时机的从来不是“间隔”，而是你何时停顿、何时切换、何时移开视线；files.autoSaveDelay 的数值调得再小，只要还在打字，它就不会启动。别把它当成 cron，它只是个编辑惰性的检测器。
