VSCode本地历史记录可找回未保存或误删代码,自动保存编辑快照,右键文件选“打开本地历史记录”查看并恢复,支持预览diff、复制或另存,注意保留天数、文件大小及排除规则。

VSCode 的本地历史记录(Local History)功能可以帮你找回意外删除、覆盖或未保存就关闭的代码,无需依赖 Git 或外部备份。
本地历史记录是什么
VSCode 会自动为每个文件在后台保存编辑快照,记录你每次保存、重命名、移动或关闭文件时的状态。这些快照存在本地(默认在工作区或系统临时目录),独立于 Git,即使没初始化仓库也能用。
如何查看和恢复历史版本
右键编辑器中的文件标签页或资源管理器里的文件 → 选择 “打开本地历史记录”(Open Local History)。 你将看到按时间倒序排列的多个快照,每条显示时间戳和简要操作说明(如 “Saved”、“Closed without saving”)。
- 点击某条记录,右侧预览变化(类似 diff),确认是否是你需要的版本
- 点击 “恢复”(Restore)可直接覆盖当前文件内容
- 点击 “复制到剪贴板” 或 “另存为…” 可先比对再决定是否替换
注意事项和常见问题
本地历史默认开启,但有几点容易忽略:
- 快照保留天数默认是 30 天,可在设置中搜索 “files.localHistory.maxFileSize” 和 “files.localHistory.duration” 调整
- 超大文件(默认 > 16MB)或被排除在
.gitignore中的文件可能不会被记录——检查设置 “files.localHistory.exclude” - 如果整个文件夹被删除,历史记录也会丢失(它依附于 VSCode 工作区元数据)
- 重启 VSCode 不影响历史,但清空系统临时目录或重装 VSCode 会导致丢失
手动触发快照更保险
别只等自动保存。每次完成一个逻辑段(比如写完一个函数、修好一个 bug),主动按下 Ctrl+S(Win/Linux)或 Cmd+S(Mac)。保存动作会立刻生成一条历史记录,提高恢复精度。
基本上就这些。不复杂但容易忽略——养成保存习惯 + 知道右键有“本地历史”,就能避开不少抓狂时刻。










