Git History 命令面板触发是唯一可靠入口，插件不提供右键菜单；VSCode 1.85+ 中命令名为 Git History: Show File History 或 View File History，需 Ctrl+Shift+P 输入执行，且文件须在 Git 仓库根目录下并已跟踪。
Git History 命令面板触发是唯一可靠入口
插件不提供右键菜单入口，装完就右键找“Git History”必然失败。VSCode 1.85+ 中命令名可能是 Git History: Show File History 或 Git History: View File History，必须用 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac）呼出命令面板后手动输入并回车。
确保当前编辑器标签页已打开目标文件，且该文件处于 Git 跟踪状态（git status 能列出它）。未保存的临时文件、未 git add 的新文件、或工作区路径与仓库根目录不一致（比如在子目录打开 VSCode，但 .git 在父级），都会导致命令不可用或历史为空。
点进提交后必须手动切到 Diff 标签才看得到改动
GitHistory 默认只显示提交元信息：作者、时间、message、哈希。它不会自动展开代码差异——这不是 bug，是设计逻辑。用户常误以为“点了就该看到改了哪几行”，结果卡在 Overview 或 Files 标签页。
Diff 标签才是真正在对比内容的地方，绿色新增、红色删除一目了然。如果点开 Diff 后仍是空白，常见原因包括：
- 该次提交中此文件是二进制文件（如图片、PDF）或被
.gitattributes显式忽略 -
core.autocrlf或core.eol配置异常，导致换行符被识别为大量变更（可临时设files.eol为\n验证） - 当前工作区未正确识别为 Git 仓库（检查左下角状态栏是否显示分支名）
想对比两个任意提交？GitHistory 本身做不到
它原生只支持单提交上下文浏览，不支持拖拽多选、Ctrl+Click 或界面内直接选 A 和 B 对比。所谓“Compare with Previous”也只是和上一个包含该文件的提交比，不是任意指定。
真正要对比两个特定提交（如 abc1234 和 def5678），得绕一下：
- 用 VSCode 内置命令：
Ctrl+Shift+P→ 输入Git: Compare with Revision，粘贴第一个哈希；再右键编辑器 →Compare with Revision粘贴第二个 - 终端更稳：
git diff abc1234 def5678 -- path/to/file，输出可复制进新建文本查看 - 跨分支对比前，务必先
git fetch，否则哈希解析失败会报fatal: bad revision 'xxx'
Timeline 视图是轻量替代方案，但别和 GitHistory 混用
VSCode 自带的 Timeline 视图（右键文件 → “在 Timeline 中打开”）也能看 Git 提交记录，但它混合了本地保存事件、文件系统修改等非 Git 条目，且不支持分支图、blame 行追溯、重命名追踪等 GitHistory 特性。
如果你只需要快速查“这个文件最近三次改了啥”，Timeline 更快；但要分析重构影响、跨分支追溯、或确认某行代码谁写的、什么时候动的，Git History: Show File History + Toggle Line Blame 才是正解。两者底层数据源不同，Timeline 不依赖插件，GitHistory 依赖完整 Git 索引和插件配置，别指望它们刷新步调一致。
