VSCode自动保存失效主因是配置被覆盖、插件拦截或文件未达可保存状态；files.autoSave必须设为"off"/"afterDelay"/"onFocusChange"/"onWindowChange"四字符串之一，设true、1等非法值将被忽略。
VSCode自动保存失效，90%不是功能坏了，而是配置被覆盖、插件拦截或文件根本没进入“可保存”状态。
files.autoSave 值写错：true、1、"on" 都不生效
VS Code 的 files.autoSave 是严格字符串枚举，只认四个值："off"、"afterDelay"、"onFocusChange"、"onWindowChange"。写成 true、1、"true"、"on" 或空字符串，VS Code 全部忽略，等效于 "off"。
常见错误现象：
- 设置里写了
"files.autoSave": true，重启后右下角状态栏仍显示「已关闭自动保存」 - 改完 JSON 文件后没反应，打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools）看到控制台无报错，但配置没加载
实操建议：
- 务必用双引号包裹字符串值，如
"files.autoSave": "afterDelay" - 选
"afterDelay"时，必须同步配files.autoSaveDelay（单位毫秒），否则延迟为 0，可能高频刷盘卡顿；推荐值1000～1500 - 别在用户设置里写
"[javascript]": { "files.autoSave": "off" }—— 这会让所有 .js 文件跳过自动保存
工作区设置(.vscode/settings.json)静默覆盖全局配置
右下角状态栏显示「工作区」时，VS Code 正在读取项目根目录下的 .vscode/settings.json。哪怕你全局设了 "files.autoSave": "onFocusChange"，只要这个文件里有 "files.autoSave": "off"，就彻底失效。
常见错误现象：
- 在新克隆的仓库里改代码，切标签页不保存；但新建一个空白文件夹再试，却正常
- 打开命令面板运行
Preferences: Open Workspace Settings (JSON)，发现里面赫然写着"files.autoSave": "off"
实操建议：
- 新建项目或拉取仓库后，第一件事就是检查
.vscode/settings.json是否硬编码禁用了自动保存 - 语言专属配置也走同一套覆盖逻辑，比如
"[markdown]": { "files.autoSave": "off" }会让所有.md文件失效 - 想临时绕过工作区设置？按
Ctrl+Shift+P→Preferences: Open User Settings (JSON)直接编辑全局配置
editor.formatOnSave 失败导致保存被静默中止
开启 editor.formatOnSave 后，VS Code 会在写入磁盘前调用格式化器。一旦 Prettier 或 ESLint 格式化失败（缺配置、语法错误、插件未激活），整个保存流程会被取消——磁盘内容仍是旧的，但状态栏一闪而过「已保存」，极易误判为自动保存失效。
常见错误现象：
- 改完代码切到终端，
git status显示没变化；用cat或外部编辑器看文件，内容确实没更新 - 开发者工具 Console 中出现
Failed to save或codeActionsOnSave报错 - 禁用所有扩展后自动保存恢复，说明是某个插件干扰
实操建议：
- 先临时禁用所有扩展，确认是否恢复；再逐个启用，定位问题插件
- 检查对应语言的格式化器是否安装并指定，例如 TypeScript 必须配
"[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - 远程开发（WSL/SSH）下格式化启动慢，可加大
files.autoSaveDelay或改用"onFocusChange"模式
权限问题导致 settings.json 写不进、文件无法落盘
Windows UAC、WSL 挂载权限错乱、或 settings.json 被标记为只读，都会让 VS Code 报「无法写入用户设置」；更隐蔽的是，工作区目录本身权限不足，导致文件修改后根本写不进磁盘——这时自动保存看似触发了，其实只是内存更新。
常见错误现象：
- 点 Settings 图形界面改配置，点保存就弹「无法写入系统设置」
- 保存文件时提示
EACCES: permission denied，尤其在/var/www、/mnt/c/Users或 WSL 挂载路径下 - 右下角状态栏显示「已保存」，但
ls -l查看文件时间戳没变，git diff也为空
实操建议：
- 手动用外部编辑器打开
settings.json路径（Windows：%APPDATA%\Code\User\settings.json），清空内容仅留{}，保存后重启 VS Code - Linux/macOS 下检查工作区目录权限：
ls -ld /path/to/project；若属主是root，执行sudo chown -R $USER:$USER /path/to/project - WSL 用户避免用
sudo code启动，否则settings.json可能变成 root 所有，普通用户再也写不了
真正容易被忽略的点：自动保存只对「有真实路径 + 右上角带 ●（修改状态）」的文件生效。新建的 Untitled-1、刚拉取未改动的文件、Git 合并冲突中的临时行（如 ），都不会触发任何自动保存逻辑。
