VSCode自动保存失效主因是设置被覆盖或触发条件不满足；需检查工作区/用户级settings.json中files.autoSave是否为合法字符串值，确认文件有路径且已修改，排除插件拦截及afterDelay模式下files.autoSaveDelay未配置等问题。
VSCode 自动保存失效，90% 不是配置写错了，而是被更高优先级的规则覆盖或触发条件不满足。直接改 files.autoSave 为 "afterDelay" 或 "onFocusChange" 后仍没反应，得一层层往下查。
检查 settings.json 的三个层级是否冲突
VSCode 设置有明确优先级：工作区 > 文件夹 > 用户。你改的是哪一级？右下角状态栏显示「工作区」时，.vscode/settings.json 就在起作用。
- 打开命令面板（
Ctrl+Shift+P），运行Preferences: Open Workspace Settings (JSON)，确认里面没有"files.autoSave": "off" - 同理检查用户级设置：
Preferences: Open User Settings (JSON)，确保files.autoSave是合法字符串值之一（"off"、"afterDelay"、"onFocusChange"、"onWindowChange"） - 别用
true、1、"true"—— 这些都会被忽略，等同于"off"
确认当前文件是否满足自动保存前提
VSCode 只对「有真实路径 + 处于修改状态」的文件生效。Untitled 文件（左下角显示 Untitled-1）、刚拉取未改动的文件、或右上角没带 ● 圆点的文件，files.autoSave 完全不触发。
- 新建 Python 文件后必须先执行
File > Save As（或Ctrl+Shift+S）指定路径，比如./src/main.py - 检查文件路径是否匹配了
files.exclude或files.watcherExclude（如"**/dist/**"），这类路径会被跳过监听 - 远程开发（WSL / SSH）下，某些路径权限或 watcher 机制不稳定，也会导致“已修改”状态无法被识别
排查插件是否静默拦截保存流程
启用 editor.formatOnSave 或 editor.codeActionsOnSave 后，Prettier、ESLint、Ruff 等插件会在保存时介入。一旦格式化失败或超时，VSCode 会中止整个保存动作——但状态栏仍会闪一下“已保存”，造成严重误判。
- 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），切到 Console 标签，复现一次保存操作，看是否有Failed to save、codeActionsOnSave或timeout报错 - 临时禁用所有扩展，再测试；若恢复，逐个启用定位问题插件（常见嫌疑：ms-python.python、esbenp.prettier-vscode、charliermarsh.ruff-vscode）
- Python 项目中，
python.linting.enabled或python.formatting.provider配置不当也可能卡住保存链路
验证 afterDelay 模式是否漏配延迟参数
选 "afterDelay" 却没反应？大概率是忘了同步设 files.autoSaveDelay。这个值不设或设为 0，VSCode 可能用默认 0 毫秒延迟，导致高频刷盘甚至卡死，尤其在 WSL 或机械硬盘上。
-
files.autoSaveDelay单位是毫秒，推荐值：800～1500；低于 300 易和格式化冲突，高于 3000 容易切走就忘 - 该延迟只对“停止输入”起作用；连续打字不会触发，停顿超过设定时间才落盘
- 注意：这个参数只在
files.autoSave为"afterDelay"时生效，其他模式下它被忽略
真正容易被跳过的点是：语言专属配置（比如 "[markdown]" 块里关掉了 files.autoSave）、files.autoSaveExclude 路径排除、以及「保存前校验逻辑」失败却不报错。这些地方不报红、不提示，只能靠 Console 日志和逐项禁用来交叉验证。
