Timeline 视图由 VSCode 内置(Git/本地历史)、GitLens(增强 Git 时间线)和 Local History(未提交快照)共同支持,可通过资源管理器标签页启用或扩展市场安装对应插件配置。

如果您在 Visual Studio Code 中看到“Timeline”视图,但无法识别其来源或扩展支持能力,则可能是由于该功能由多个独立扩展提供,而非单一插件。以下是了解与配置 Timeline 功能的多种方式:
本文运行环境:MacBook Air M2,macOS Sequoia。
一、启用内置文件时间线视图
VSCode 自 1.62 版本起在资源管理器底部集成原生 Timeline 视图,无需额外安装扩展即可查看当前文件的 Git 提交历史、本地保存记录等时序信息。
1、在编辑器中打开任意受 Git 管理的文件。
2、点击编辑器右上角的三个点图标,选择“在资源管理器中显示”或直接按 Cmd+Shift+E 呼出资源管理器。
3、在资源管理器底部找到并点击 Timeline 标签页。
4、确认右上角齿轮图标中已勾选“Git: Show File History”与“Local History: Show Local History”。
二、安装 GitLens 扩展增强 Timeline
GitLens 是目前最广泛使用的 Timeline 增强工具,它将 Git 提交、分支切换、作者变更等元数据以时间轴形式结构化呈现,并支持跳转到具体提交版本。
1、打开 VSCode 扩展市场(Cmd+Shift+X),搜索 GitLens。
2、点击安装并重启 VSCode。
3、右键编辑器内任意代码行,在上下文菜单中选择“GitLens: Show Timeline View”。
4、在新打开的 Timeline 面板中,点击某条提交项右侧的 ⋯ 可执行比较、复制哈希、打开提交详情等操作。
三、使用 Local History 扩展补充本地快照
当文件未纳入 Git 管理或需追溯未提交的编辑变更时,Local History 扩展可自动保存每次保存前的副本,并将其注入 Timeline 视图。
1、在扩展市场中搜索并安装 Local History(作者:xyz.local-history)。
2、安装后无需配置,默认每 30 秒自动创建一次快照,且保留最近 30 个版本。
3、打开任意文件,在资源管理器 Timeline 标签页中,向下滚动即可看到标记为 Local 的条目。
4、点击某条本地历史记录,右侧将显示差异预览;双击可恢复至该版本。
四、通过 Settings Sync 同步 Timeline 配置
若在多台设备间使用同一 VSCode 账户,Timeline 相关扩展行为(如 GitLens 的提交过滤规则、Local History 的保留数量)可通过设置同步保持一致。
1、登录 VSCode 内置账户(File → Account → Sign in to Sync)。
2、进入设置(Cmd+,),搜索 sync,确保“Settings Sync: Enabled”为开启状态。
3、在“Settings Sync: Extensions”设置项中,确认 GitLens 与 Local History 已被包含在同步列表中。
4、点击右下角同步图标,触发立即上传当前扩展配置。










