VSCode本地历史默认开启，保存后自动生成快照，30天或50条上限；右键文件选“Open Timeline”查看/恢复；外部修改文件路径或禁用回收站会导致记录丢失；建议配合Git使用并避免系统级操作。
VSCode 的本地历史记录（Local History）功能可以在没有 Git 提交的情况下，帮你找回最近修改、删除甚至误覆盖的代码。它自动保存编辑器中文件的变更快照，无需额外配置，但需注意它依赖工作区和文件系统行为，不是万能备份。
本地历史记录怎么开启和触发
这个功能默认开启，不需要手动打开。只要你在 VSCode 中对文件进行了保存（Ctrl+S / Cmd+S），它就会在后台自动生成一个时间戳快照。即使你没提交到 Git，也没开任何插件，只要文件被保存过，历史就存在。
- 每次保存都会生成一条记录，间隔默认约 2 分钟（如果连续编辑，不会每秒都存）
- 历史最多保留 30 天，或最多 50 条（以先到者为准），旧记录会自动清理
- 只记录已保存的文件，未保存的草稿（dirty file）不会进入历史
如何查看和恢复某次修改
右键点击编辑器中的文件标签页，或资源管理器里对应文件，选择 “Open Timeline”（打开时间线）。左侧会弹出面板，列出该文件的所有本地历史版本，带时间戳和简要操作描述（如 “Saved”、“Renamed”）。
- 点击某条历史记录，右侧预览对比视图会显示和当前文件的差异（类似 Git diff）
- 确认是你要恢复的版本后，点击右上角的 “Restore” 按钮即可覆盖当前文件内容
- 也可右键某条记录 → “Copy to Clipboard”，把旧内容粘贴到新文件中做比对或部分还原
为什么有时找不到历史记录
本地历史依赖 VSCode 的工作区状态和文件路径一致性。以下情况会导致记录丢失或不可见：
- 文件被外部程序（如系统编辑器、命令行
rm或mv）直接删除或重命名——VSCode 不感知，历史随之消失 - 整个文件夹被移动或重命名（尤其从资源管理器拖动），VSCode 可能断开与原历史的关联
- 关闭了工作区或使用了“Open Folder”但路径变了，历史只绑定在原始打开方式下
- 设置了
"files.enableTrash" : false且用 Shift+Delete 彻底删除文件，可能跳过回收站机制，历史同步失效
增强可靠性的实用建议
本地历史是应急兜底，不能替代正规版本控制。日常开发中建议搭配使用：
- 哪怕只是
git init && git add . && git commit -m "init"，再小的项目也值得起步 - 开启 VSCode 的自动保存（
"files.autoSave": "afterDelay"），让历史更密集、更及时 - 避免用系统命令操作正在编辑的文件；改名/移动尽量通过 VSCode 资源管理器完成
- 定期导出重要片段：右键时间线里的某条记录 → “Save As…” 可另存为临时备份文件
基本上就这些。本地历史不复杂，但容易忽略——它救过不少人的命，尤其是 Ctrl+Z 失效、Git 还没提交、又刚手滑删掉半屏代码的时候。
