Local History 是不依赖 Git 的文件级快照工具,自动保存 Ctrl+S 的完整副本,支持误删恢复、未提交修改回溯;Git History 可视化 Git 提交记录与单行演化;Timeline 是 VSCode 内置磁盘快照机制,需文件曾保存才有效。

Local History:不依赖 Git 的文件级快照回溯
它不是 Git 替代品,而是补位工具——当你还没 git add、甚至没初始化仓库时,它已默默存下每次 Ctrl+S 的完整文件副本。适合误删后秒恢复、临时改炸了想退回上一版、或断电重启后捞回未提交的修改。
关键点:
- 默认在项目根目录生成
.history文件夹,路径可配localHistory.storagePath - 快照触发时机:保存(
autoSave: true)、关闭文件(saveOnClose: true)、甚至编辑中(需开启saveOnChange,但慎用,IO 压力大) - 每个文件最多保留
maxEntriesPerFile条记录,默认 50;超期条目按maxAgeDays自动清理 - 右键文件 →
Local History: Show History即开时间线,选中节点点Restore覆盖当前编辑器内容(注意:不可撤销)
Git History:聚焦 Git 提交层的历史可视化
它不存新数据,只把本地 Git 仓库里的提交日志、文件变更、甚至某一行代码的修改轨迹,用图形界面摊开给你看。适合查“这个函数是谁什么时候改坏的”“这个配置项在哪次提交里加的”。
典型操作场景:
- 右键文件 →
Git: View File History查该文件所有 commit 记录 - 编辑器中选中某行 → 右键 →
Git: View Line History追溯单行演化 - 命令面板搜
git.viewHistory看整个仓库时间轴 - 配置
gitHistory.maxDepth防止大型仓库加载卡死(Apollo 项目建议设为 100+)
Timeline 视图:VSCode 内置的磁盘快照兜底方案
不是插件,但常被忽略——它是 VSCode 自带的、基于操作系统文件系统事件的轻量级历史机制。只要文件曾被保存过,哪怕你关了编辑器、重启了电脑,它仍可能找回几小时前的版本。
使用限制和要点:
- 快捷键:
Ctrl+Alt+F(Windows/Linux)或Cmd+Option+F(macOS),聚焦文件后触发 - 只显示带
Saved标签的节点才可靠;Modified是内存缓存,关文件即丢 - 若提示
Cannot restore — file has unsaved changes,先Ctrl+S或执行File: Revert File - 不记录未保存的更改,也不跨工作区共享历史
别混淆 Undo History 和 Local History
Ctrl+Shift+P → Edit: Undo History 打开的是纯内存栈,记录的是编辑动作(如 Delete Line、Paste),关文件就清空。而 Local History 存的是磁盘副本,哪怕你刚重装系统、换电脑,只要把 .history 文件夹一起拷走,就能恢复。
真正容易被忽略的是:Timeline 和 Local History 都依赖文件曾被保存过;如果某次修改后你只 Ctrl+Z 撤销又没再保存,那它既不在 Undo History 里,也不在任何磁盘快照中——这种“空气修改”永远无法找回。


















