VS Code Timeline 怎样查看文件的本地修改记录

在 VS Code 里查看一个文件之前的保存版本，不一定要先打开 Git 图形界面。打开文件后，展开 Explorer 底部的 Timeline，再用过滤器保留 Local History，就能查看本地保存记录。选中记录可以先比较差异，确认无误后再恢复。

官方地址：https://code.visualstudio.com/docs

从 Explorer 打开文件的 Timeline

先在 VS Code 中打开需要回看的文件，再按 Shift+Command+E（Windows/Linux 为 Ctrl+Shift+E）进入 Explorer。选中文件后，向下查看 Explorer 面板，找到并展开 Timeline。

Timeline 展示的是当前活动文件的事件。项目启用了 Git 时，列表里可能同时出现提交记录和本地保存记录；没有 Git 提交时，仍可以看到本地历史产生的事件。

筛选 Local History，避免把 Git 提交混在一起

在 Timeline 工具栏打开过滤器。需要查看本机保存过的内容时，保留 Local History，暂时取消 Git History。这样列表中的每个条目都对应编辑器本地保存产生的历史，而不是仓库里的提交。

选中一条记录后，先看差异再决定下一步。比较操作适合确认某次保存到底改了哪些行；只有确认这条记录完整、且确实要覆盖当前内容时，才使用恢复入口。删除或重命名历史条目也应在确认记录对象后进行，避免误操作当前文件。

找不到本地记录时，先看这几个设置

如果 Timeline 只有 Git 记录，或者某次保存没有形成新的本地条目，先检查设置面板中的以下项目。它们决定记录是否启用、文件是否超过大小限制，以及相邻保存是否合并。

这些设置只解释本地历史的记录范围，不等价于 Git 提交。需要长期、可协作的版本记录时，仍应提交到版本控制系统；Timeline 更适合找回刚才误改或误删的文件状态。

恢复前后怎么确认没有覆盖错内容

1. 确认编辑器当前打开的文件名和路径，避免 Timeline 处于另一个文件的上下文。
2. 从 Local History 中选择目标时间点，先打开差异视图。
3. 重点检查配置键、导入语句和末尾换行等容易被忽略的改动。
4. 执行 Restore 后回到编辑区，确认文件内容已经回到预期状态，再决定是否保存或提交。

如果文件已经从工作区删除，可以在 Timeline 的更多操作中使用 Local History: Find Entry to Restore，再从快速选择列表中找到文件。这个入口用于找回本地历史中的文件，不代表所有曾经存在的文件都一定永久保留。

常见问题

Timeline 为什么只显示 Git 提交？

先打开过滤器，确认 Local History 没有被取消；再检查 workbench.localHistory.enabled 和排除规则。Git 提交与本地保存是两类来源，默认可能同时出现在同一个 Timeline 中。

连续保存为什么没有出现很多条记录？

相邻保存可能受 workbench.localHistory.mergeWindow 合并，单个文件还受 maxFileEntries 限制。应先看时间点和差异内容，而不是只按条目数量判断是否记录成功。

恢复 Local History 会不会修改 Git 提交？

恢复动作先改变当前工作区文件内容，不会直接改写已有 Git 提交。恢复后如果内容正确，仍需按正常版本控制流程查看差异并决定是否提交。

日常排查可以记住一条路径：打开目标文件 → Explorer → Timeline → 过滤 Local History → 先 Compare，再 Restore。若记录缺失，再检查本地历史开关、文件大小、条目上限和排除规则。