VSCode本地历史依赖本地.history文件夹，若显示“No local history available”则快照已丢失；需检查该目录存在性及权限，并确保文件已保存且位于有效工作区；自动保存设置影响快照密度，建议设为onFocusChange；历史保留受maxFileEntries和maxFileSize限制，长期备份应使用Git。
本地历史还原前先确认它还在不在
VSCode 的 Local History 不是“随时可查的云端备份”，而是一套依赖本地磁盘文件的快照机制。如果还原时点开就显示 “No local history available”，大概率不是操作错了，而是快照本身已经丢失。最直接的验证方式是去工作区根目录下看 .history 文件夹是否存在、是否有内容：
在终端里执行 ls -la .history/（macOS/Linux）或 dir .history（Windows）。正常应看到一堆类似 src%2Findex.ts%2F2024-05-22T14-32-18.123Z.json 的文件——路径编码 + 时间戳。空目录、权限拒绝、或整个 .history 被删掉，都会导致还原功能失效。
右键“Reveal in Local History”没反应？试试命令面板入口
资源管理器右键菜单里的 Reveal in Local History 有时会因文件未保存、或当前处于未关联工作区的单文件模式而灰掉。这不是 bug，是设计限制：VSCode 只对已保存、且位于有效工作区（即打开的是文件夹或 .code-workspace）内的文件生成快照。
更可靠的入口是命令面板：
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux） - 输入并选择
Local History: Show History for Current File - 选中某条记录后，点击右侧
Compare with Current查差异，或右键选Restore from Local History
这个路径绕过了资源管理器的上下文判断，只要 .history 里有对应快照，就能调出来。
还原后发现内容不对？检查自动保存是否被关了
本地历史只在文件被保存（Ctrl+S 或触发 files.autoSave）时才捕获快照。如果你习惯写一大段再存，那中间所有修改都不会出现在历史里——还原只能回到上一次保存点，不是“上一秒”。常见坑包括：
-
files.autoSave设置为off，又忘记手动保存 -
files.autoSave是afterDelay，但延迟设得过大（比如 10 秒），而你在 3 秒内就切走了窗口 -
files.hotExit设为off，崩溃后未保存内容直接丢弃，连临时恢复都不可用
建议把 files.autoSave 设为 onFocusChange，切换编辑器标签或离开 VSCode 窗口时自动落盘，历史记录更密、更可靠。
想找回几天前的修改，但历史只显示最近几小时
VSCode 默认只保留 30 天内的快照，但实际能看见多久，取决于两个配置项是否被改小了：
-
files.localHistory.maxFileEntries：单个文件最多存几个快照，默认 50。如果频繁保存，老快照会被新快照顶掉 -
files.localHistory.maxFileSize：超过该大小（单位 MB）的文件不存历史，默认不限制。但若你设成 1，那所有 >1MB 的文件就彻底没历史了
另外，.history 目录本身不会自动清理过期文件，它靠 VSCode 启动时扫描时间戳来判断是否过期。所以如果你长期不打开某个工作区，里面的历史也不会被主动删除——但一旦打开，旧快照可能就被批量清理了。真要保长期记录，别依赖这个功能，该上 Git 还是得上。
