VSCode Timeline视图：查看文件和Git的变更历史

VSCode 的 Timeline 视图用于快速查看单个文件的变更历史，聚合显示 Git 提交、文件系统修改和 VSCode 保存时间点；可通过右键菜单或命令面板打开，支持搜索、筛选及差异对比。

VSCode 的 Timeline 视图是快速查看单个文件变更历史的实用工具，它把文件系统修改、Git 提交记录、保存时间点等统一聚合展示，无需切换到源代码管理面板或命令行就能直观掌握“这个文件什么时候被谁改过什么”。

Timeline 视图怎么打开？

在资源管理器中右键点击任意文件 → 选择 “在 Timeline 中显示”；或者用快捷键 Ctrl+Shift+P（Win/Linux）/Cmd+Shift+P（Mac），输入 “Timeline: Focus on Timeline View” 并回车。打开后，右侧会显示该文件的时间线列表，默认按时间倒序排列。

Timeline 显示哪些类型的变更？

默认情况下，Timeline 会混合显示以下几类事件：

• Git 提交记录：每次该文件在 Git 中被提交的版本、作者、提交信息、时间
• 本地文件修改时间：系统记录的最后修改时间（取决于文件系统，非 VSCode 自身保存）
• VSCode 保存时间点（需启用）：如果开启 "files.autoSave": "onFocusChange" 或手动保存，且安装了支持插件（如 File History），部分用户可能看到保存快照项

注意：纯编辑未保存、撤销重做、临时缓存等操作不会出现在 Timeline 中。

如何筛选和定位关键变更？

Timeline 视图顶部有搜索框和筛选按钮：

• 输入关键词（如作者名、提交信息片段、分支名）可快速过滤 Git 条目
• 点击右上角漏斗图标，可关闭“文件系统修改”或“Git 提交”，只看其中一类
• 点击某条 Git 记录，右侧自动打开差异比较视图（Compare with Previous），直接对比当前与上一版改动
• 右键某条记录，可选择 “复制提交哈希”、“在提交中打开文件” 或 “还原更改”（仅限工作区未暂存的修改）

常见问题与注意事项

Timeline 不是万能日志，使用时需留意：

• Git 条目依赖本地仓库状态 —— 如果文件未纳入 Git 跟踪，或当前不在 Git 仓库内，Timeline 只显示文件系统修改时间
• 无法查看跨文件的关联变更，也不支持按目录或分支聚合 —— 这类需求仍需用 Source Control 视图或 Git 图形工具
• 某些远程 Git 服务（如 GitHub）的 PR 修改、CI 构建触发的提交，若未同步到本地，Timeline 不会显示
• 时间精度为秒级，高频保存（如每秒自动保存）可能导致大量重复条目，建议合理配置 autoSave

基本上就这些 —— Timeline 是轻量但精准的“单文件时间轴”，用对场景，查历史、比差异、回退小修改都很顺手。