vscode自动保存失效常因插件拦截或工作区覆盖：eslint等插件通过codeactionsonsave失败会中止保存；.vscode/settings.json中files.autosave:"off"会覆盖全局设置。
插件拦截保存流程导致文件没写入磁盘
VSCode 的 files.autoSave 设为 "afterDelay" 或其它有效值后仍不保存，大概率不是设置没生效，而是某个插件在“保存前”卡住了整个流程。典型表现是：你切换焦点或等待延迟后，编辑器右上角的「已修改」星号一直不消失，Ctrl+S 也无反应，控制台里能看到类似 Failed to save 或 codeActionsOnSave failed 的报错。
常见干扰插件包括：ESLint、Prettier、TypeScript、EditorConfig 等——它们常通过 editor.codeActionsOnSave 配置项，在保存时自动执行格式化或校验。一旦其中某步失败（比如 ESLint 规则报错、Prettier 解析卡死），VSCode 就会中止保存动作，连带跳过磁盘写入。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签页，复现一次“本该保存却没保存”的操作，观察是否有红字报错 - 临时禁用所有插件（
Ctrl+Shift+P→Extensions: Disable All Installed Extensions），重启 VSCode，测试自动保存是否恢复 - 确认是某插件引起后，不要直接卸载，而是检查其
codeActionsOnSave相关配置，例如把"editor.codeActionsOnSave": { "source.fixAll.eslint": true }改为false，或加上"source.organizeImports": false等兜底项
工作区设置覆盖全局 autoSave 导致失效
你明明在用户设置里把 files.autoSave 改成了 "onFocusChange"，但项目一打开还是不自动存——大概率是项目根目录下的 .vscode/settings.json 里写了同名配置，且值为 "off"。VSCode 的设置优先级是：工作区设置 > 用户设置，后者会被前者完全覆盖，连提示都不会给。
尤其容易被忽略的是团队协作场景：别人提交的 .vscode/settings.json 里可能为了适配 CI 流程，强制关掉了自动保存；你 clone 下来直接开项目，就继承了这个行为。
- 按
Ctrl+Shift+P输入Preferences: Open Workspace Settings (JSON)，检查是否存在"files.autoSave"字段 - 如果存在且值为
"off"，要么删掉这行（让设置回落到用户级），要么改成你需要的值，如"afterDelay" - 注意：某些脚手架（如 Create React App、Vite 模板）生成的
.vscode/settings.json默认含"files.autoSave": "off"，需手动清理
Local History 插件与 Timeline 视图不显示记录
你以为开了自动保存就万无一失，结果代码丢了发现 Timeline 里空空如也，或者 .history/ 文件夹根本不存在——这通常不是插件坏了，而是它压根没触发记录条件。Local History（以及原生 Timeline）只对「在 VSCode 中打开并显式保存过」的文件生效，新建文件没按过 Ctrl+S、或文件路径不在当前工作区范围内，就不会留痕。
更隐蔽的问题是：某些插件（如 GitLens）或远程开发模式（SSH/WSL）会改变历史快照的存储位置，导致 GUI 找不到，但数据其实还在。
- 先确认
files.localHistory.enabled是true（默认开启），且files.enableTrash没被设为false - 打开项目根目录，显示隐藏文件，看是否存在
.history/文件夹；若无，说明 Local History 从未成功写入过任何快照 - 远程开发时，去远端机器查
~/.vscode-server/data/User/History/（Linux/macOS）或对应 WSL 路径，用ls -lt按时间排序找最近文件 - 命令面板输入
Developer: Show Local History，比点击侧边栏 Timeline 更可靠，能绕过 UI 缓存问题
备份目录里有文件但内容乱码或无法识别
系统崩溃后进 %APPDATA%\Code\Backups\（Windows）或 ~/Library/Application Support/Code/Backups/（macOS）翻出一堆哈希命名的文件，用 VSCode 打开却发现开头是乱码或 JSON 结构异常——这不是损坏，而是 VSCode 备份文件自带元数据头。真实内容从第一个 { 开始，前面全是描述信息（如文件路径、编码、时间戳等），必须手动删掉。
特别是 .ipynb 这类结构化文件，备份头更长，直接另存为原后缀会因头部污染导致解析失败。
- 用 VSCode 打开备份文件，滚动到第一个
{字符处，选中并删除它之前的所有内容（包括换行） - 保存时务必指定正确后缀，例如原文件是
script.ts，就另存为script.ts，不是xxx.backup - 若不确定开头哪行该删，可对比两个备份文件的时间戳，取较新的那个，通常头部更完整，内容更接近崩溃前状态
自动保存从来不是单点开关，而是用户设置、工作区配置、插件行为、文件生命周期共同作用的结果。最危险的误区，就是改完 files.autoSave 就以为万事大吉——只要有一个插件在保存链路上抛错，或一个 .vscode/settings.json 里埋着 "off"，你的代码就仍在裸奔。防丢的关键，是让保存动作可见、可验证、有回退路径，而不是依赖某一层抽象的“自动”承诺。
