VSCode内置Timeline视图需同时满足文件在Git仓库中、已git add、且已保存三个前提才能显示Git提交和本地快照；否则面板空白或仅显示“no entries”，因其仅消费Git提交历史和文件系统mtime两种数据源。
VSCode 内置 Timeline 视图能直接查看 Git 提交记录和本地保存快照，但必须满足三个硬性前提：文件在 Git 仓库中、已 git add 过、且已保存 —— 缺一不可，否则 Timeline 面板空白或仅显示“no entries”。
Timeline 打不开或显示“No timeline entries”的真实原因
不是功能坏了，而是 VSCode 根本没拿到数据源。Timeline 不是本地快照工具，它只消费两种输入：Git 提交历史（来自 git log）和文件系统修改时间（来自 fs.stat().mtime）。常见卡点：
- 项目根目录没有
.git文件夹，或 VSCode 打开的是单个文件而非文件夹（File → Open Folder才行） - 文件是新建的，
git status显示为untracked，没执行过git add - 改完内容但没按
Ctrl+S，未保存的编辑不会触发任何 Timeline 条目 - VSCode 版本低于 1.65，Git 时间线支持未启用；1.84+ 才默认开启
git.timeline.enabled
如何确认 Timeline 正在读取 Git 而非仅文件系统
Timeline 默认混合显示 Git 和文件系统事件，但两者来源不同、行为不同。关键区分点：
- Git 条目带 commit hash（如
abc1234），hover 提示含 author、message；文件系统条目只有“已保存”“已恢复”文字，无哈希 - 点击 Git 条目右侧的
⋯→ “Compare with Workspace”，能打开完整 diff；文件系统条目点“Compare with Previous”可能失败或空白（尤其编码非 UTF-8 时） - 右键 Timeline 条目 → “Copy Source”，Git 条目复制的是
git:sha:path/to/file，文件系统条目复制的是绝对路径 - 若只看到文件系统条目，检查设置里是否误关了
git.timeline.enabled（需设为true）
“Local History” 快照到底怎么生成？别依赖自动保存
VSCode 内置的本地保存快照（Local History）不是每次 Ctrl+S 都存，它有明确触发策略和限制：
- 仅对已
git add但未git commit的文件生效；一旦暂存（staged），后续保存不再生成新快照 - 快照由后台定时采集（约每 30 秒一次），不是实时监听；手动保存后立刻关闭文件，快照可能根本没来得及写入
- 默认最多保留 50 条/文件、30 天，老快照会被自动清理；可通过设置
files.localHistory.maxFileEntries和files.localHistory.retentionPeriod调整 - 快照存储在系统临时目录（如
/tmp/vscode-local-history），清空系统缓存会丢失所有记录
还原某次修改的唯一安全方式
Timeline 本身不提供“一键回退”按钮（Revert to This Version 是 GitLens 等插件功能）。纯内置方案只有两步：
- 点击 Git 条目 → 按
Enter或双击，打开内联 diff 视图 - 在 diff 左侧（历史版本）选中要恢复的代码块 →
Ctrl+C→ 切到当前编辑器右侧 →Ctrl+V覆盖 →Ctrl+S保存 - 注意：
Open File at Revision打开的是只读快照，标题栏显示filename.ts (commit: abc1234)，直接保存会报错"Cannot save since it is not part of the workspace" - 如果 diff 区域空白，先检查文件右下角编码是否为
UTF-8；再右键条目 → “Copy Commit SHA”，终端运行git show abc1234:path/to/file验证原始内容是否可读
真正容易被忽略的是：Timeline 的 Git 数据源只读取当前分支 HEAD 可达的提交，git stash、reflog、已合并但不在当前分支历史中的提交，全都不显示 —— 它不是 Git 全量日志浏览器，只是当前工作区的一个轻量投影。
