VSCode本地历史记录功能可找回未提交的误删代码,需确认启用、通过资源管理器或命令面板查看历史、选择版本还原,并可调整保留策略。

如果您在VSCode中编辑文件时意外删除了重要代码,但尚未提交到Git仓库,则本地历史记录功能可以帮您快速找回最近的修改状态。以下是启用和使用该功能的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、确认本地历史记录功能已启用
VSCode默认开启本地历史记录功能,它会自动为每个文件保存一定时间内的变更快照,无需Git仓库即可工作。该功能独立于源码控制系统,是编辑器层面对文件变更的自动备份机制。
1、打开VSCode,按下 Cmd + , 打开设置界面。
2、在搜索框中输入 files.localHistory.enabled。
3、确认对应设置项右侧开关处于开启状态(蓝色)。
二、通过资源管理器查看本地历史
本地历史记录以时间戳形式组织,可在资源管理器中直接浏览并对比任意两个版本之间的差异。
1、在左侧资源管理器中,右键点击目标文件。
2、在弹出菜单中选择 “Reveal in Local History”。
3、右侧将展开本地历史面板,显示该文件所有可恢复的时间点。
三、通过命令面板调用本地历史
命令面板提供统一入口,适用于当前打开文件或未保存更改的场景,尤其适合快速定位最近一次编辑前的状态。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 “Local History: Show History for Current File”。
3、从列表中选择一个历史版本,点击右侧的 “Compare with Current” 查看差异。
四、还原指定历史版本
还原操作将用所选历史快照完全覆盖当前文件内容,不产生新提交,不影响Git工作区状态。
1、在本地历史面板中,右键点击目标时间点。
2、选择 “Restore from Local History”。
3、确认弹窗提示,文件内容将立即恢复至该时刻的完整状态。
五、调整本地历史保留策略
本地历史占用磁盘空间,默认保留30天内变更,可通过配置限制单个文件历史数量或总存储容量,避免缓存膨胀。
1、打开设置界面,搜索 files.localHistory.maxFileSize,将其值设为 50(单位MB)以排除超大文件。
2、继续搜索 files.localHistory.maxFileEntries,将其设为 50 以限制单文件最多保存50个快照。
3、再搜索 files.localHistory.exclude,添加 "**/node_modules/**" 等路径以跳过特定目录。










