VSCode 的 Timeline 和 Git 历史功能需同时满足三个前提：文件在 Git 仓库中、已提交过、VSCode 以文件夹形式打开含 .git 的根目录；否则功能不启动，非插件故障。
能直接看，但必须满足三个前提：文件在 Git 仓库里、已提交过、VSCode 打开的是整个文件夹。缺任何一个，Timeline 或 Git 历史都会失效——不是功能坏了，是机制不启动。
右键“View File History”没反应？先确认 Git 上下文
这个命令只对 git status 能列出的文件生效。如果右键菜单里压根没 “Git: View File History”，别急着重装插件，先检查：
- 左下角状态栏是否显示分支名（如
main）；没显示说明 VSCode 没识别到 Git 仓库 - 终端执行
git status，看是否返回 “On branch …”；如果报错 “not a git repository”，得先git init - 是否只拖了一个文件进 VSCode？必须用
File → Open Folder打开含.git的根目录
Timeline 显示 “No timeline entries”？不是没记录，是没触发条件
Timeline 面板依赖 Git 提交 + 本地快照双轨机制，但本地快照有硬限制：
- 新文件保存后，必须没执行过
git add，才会生成 Local History 条目；一旦暂存，后续编辑就只记 Git 提交 - 快照最多存 50 条、30 天，且后台约每 30 秒扫一次——改完立刻关文件，大概率来不及存
- 编码不是
UTF-8（右下角点编码 →Reopen with Encoding）会导致 Compare 功能失灵
想对比当前和上次 commit？别点 “Open Changes”，走两步
Git: Open Changes 默认对比的是「工作区 vs 暂存区」，不是你想要的「和最近一次 commit 比」。正确流程是：
- 先运行
git add <file>（哪怕只是临时加一下） - 再执行
Git: Open Staged Changes，这时左侧才是 HEAD 内容，右侧是当前编辑 - 如果
git show --name-only HEAD能列出该文件，但 VSCode 里看不到 diff，大概率是换行符问题：git config core.autocrlf false试试
提交历史里找不到某次修改？可能根本没进 Git
在源代码管理视图中点击某次提交旁的 ▶️ 展开 Files 列表，如果为空或只列了 .vscode/ 类配置文件，说明这次提交实际没包含代码变更：
- 可能是空提交（
git commit --allow-empty） - 也可能是改了未跟踪文件（比如新建的
temp.js没git add就直接 commit） - 大仓库下 VSCode 渲染可能卡住，终端最准：
git show --name-status abc1234直接输出 M/A/D 文件列表
真正容易被忽略的点是：Timeline 和 Git 历史是两条独立路径，前者只保留快照，后者才存真实内容。想靠 Timeline 找回三天前删掉的函数？前提是那会儿它已被提交过，否则快照早被自动清理了。
