VSCode的Local History功能可恢复未提交的误删或错误修改内容。需启用自动保存、垃圾箱及本地历史设置，支持查看差异、手动创建快照、清理历史及命令面板快速访问。
如果您在VSCode中编辑文件时误删内容或修改出错，但尚未提交到Git仓库，则可以依赖内置的“Local History”功能恢复先前状态。以下是启用和使用该功能的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用Local History自动记录
VSCode默认开启Local History，但需确认相关设置未被禁用。该功能会在后台持续保存文件的变更快照，不依赖外部版本控制系统。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 files.autoSave，确保其值为 afterDelay 或 onFocusChange。
3、继续搜索 files.enableTrash，确认其值为 true。
4、搜索 workbench.localHistory.enabled，确保其勾选状态为启用。
二、查看并恢复历史版本
Local History会为每个文件维护一个时间线快照列表，用户可随时比对差异并还原至任意历史节点。
1、在资源管理器中右键点击目标文件。
2、选择 Local History: Show History。
3、在弹出的侧边栏中，点击任一时间戳条目以打开差异视图。
4、在差异视图中点击 Restore 按钮，即可将当前文件覆盖为所选历史版本。
三、手动创建历史快照
除自动记录外，用户可在关键编辑节点主动保存快照，避免因自动间隔遗漏重要状态。
本地项目发布到GitHub的完整工作流助手。自动执行：安全检查（.gitignore、排除敏感.env/凭据文件）、补齐开源文件（LICENSE、.gitignore）、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词："发布到GitHub"、"上传到github"、"
1、打开需保存的文件。
2、按下 Cmd + Shift + P 调出命令面板。
3、输入并选择 Local History: Create History Entry。
4、在弹出的输入框中为该快照添加描述性名称，例如 before-refactor。
四、清理过期历史记录
Local History占用本地磁盘空间，系统默认保留30天内的快照；手动清理可释放空间并提升性能。
1、右键点击目标文件或文件夹。
2、选择 Local History: Delete All History 删除全部记录。
3、如仅删除指定文件的历史，选择 Local History: Delete History for This File。
五、通过命令面板快速访问历史
无需鼠标操作，可通过快捷命令直接调出历史列表，提升高频操作效率。
1、聚焦于编辑器中的任意文件。
2、按下 Cmd + Shift + P。
3、输入 Local History: Show History 并回车执行。
4、使用方向键浏览时间条目，按 Enter 查看差异，按 R 快速恢复。
