Timeline 视图不显示提交或变更时间线，需依次启用内置功能、安装 GitLens 扩展、确认 Git 仓库初始化、切换数据源类型、重置 Timeline 缓存。
如果您在 VSCode 中使用 Timeline 视图查看文件历史记录，但无法显示提交、保存或 Git 变更时间线，则可能是由于资源未启用、扩展缺失或工作区配置异常。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用内置 Timeline 功能
VSCode 自 1.63 版本起内置 Timeline 视图，但需确保相关功能未被禁用。该视图依赖于文件系统事件监听与 Git 扩展集成，禁用后将不触发时间线数据加载。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Preferences: Open Settings (JSON)。
3、在 settings.json 中确认不存在以下禁用项：“timeline.enabled”: false 或 “git.timeline.enabled”: false。
4、如存在，将其删除或改为 true，保存后重启 VSCode。
二、安装并启用 GitLens 扩展
原生 Timeline 仅支持基础 Git 提交历史，GitLens 可扩展 Timeline 视图以显示文件保存历史、分支变更、作者信息等，是增强“时光机”能力的关键补充。
1、点击左侧活动栏的扩展图标（四个方块组成的图标）。
2、在搜索框中输入 GitLens，找到官方扩展（作者为 GitKraken）并点击安装。
3、安装完成后，右键任意编辑器标签页，选择 Timeline: Show Timeline。
4、若仍不可见，在命令面板中执行 GitLens: Toggle File History Graph 启用图形化时间线。
三、检查工作区 Git 初始化状态
Timeline 视图严重依赖当前文件是否位于已初始化的 Git 仓库中。若文件路径未纳入 Git 管理，或仓库 .git 目录损坏，时间线将为空白或仅显示本地保存点（无提交记录）。
1、在 VSCode 终端中执行 git status，确认输出包含有效仓库路径及未暂存 / 已暂存文件信息。
2、若提示 not a git repository，则进入项目根目录，运行 git init 初始化。
3、执行 git add . && git commit -m “init” 创建首次提交，确保至少一个历史节点存在。
四、切换 Timeline 数据源类型
VSCode Timeline 支持多数据源叠加显示，包括 Git 提交、文件系统保存事件、GitHub Pull Requests 等。默认可能仅启用部分源，导致时间线内容稀疏。
1、在编辑器顶部点击 Timeline 标签右侧的齿轮图标（设置按钮）。
2、勾选全部可用选项，特别是 File System 和 Git。
3、取消勾选 Only show entries for current file 可临时查看整个仓库的时间脉络。
4、关闭设置面板后，点击 Timeline 区域右上角刷新图标强制重载数据源。
五、重置 Timeline 缓存并重建索引
Timeline 视图会缓存 Git 日志解析结果与文件变更哈希，缓存损坏时会导致时间线停滞在旧状态，不响应新提交或保存动作。
1、关闭所有 VSCode 窗口，确保后台进程已退出。
2、在终端中执行：rm -rf ~/.vscode/extensions/gitkraken.gitlens-*/out/extension/timeline-cache（macOS/Linux）。
3、重新打开 VSCode 并打开目标工作区。
4、等待右下角状态栏出现 GitLens: Indexing repository… 提示，待其完成后再查看 Timeline。
