GitHistory插件需通过命令面板触发，右键无入口；点提交后需手动切至Diff标签查看改动；不支持双提交对比，需借助VSCode内置命令或终端；历史不自动刷新，须手动点击Refresh或重启命令。
GitHistory 插件装了但点不开文件历史
插件本身不提供右键菜单入口，必须用命令面板触发。很多人装完就右键找“Git History”，结果什么都没出现——这是最常卡住的第一步。
正确做法是：Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Git History: View File History 并回车。此时会弹出当前打开文件的提交时间线。
- 确保当前编辑器标签页已打开目标文件，未保存的临时文件或未加入 Git 的文件无法触发
- 如果命令搜不到，检查插件是否启用：在扩展页搜索
git history，确认git-history（作者：donjayamanne）状态为“已启用” - VSCode 1.85+ 版本中，该命令名可能缩写为
Git History: Show File History，名称微调但功能一致
点击某次提交后看不到代码差异
GitHistory 默认只显示提交元信息（作者、时间、消息），不自动展开 diff。用户误以为“点进去就该看到改了哪几行”，其实要手动再点一次。
进入某次提交详情页后，页面顶部有三个标签：Overview、Files、Diff。真正看改动得点开 Diff 标签。
-
Files标签列出本次提交涉及的所有文件，但不显示内容变化 - 如果点
Diff后仍是空白，大概率是该文件在那次提交中被跳过（比如二进制文件、大文件被 Git 忽略），或当前工作区路径与仓库根不匹配 - 注意：diff 渲染依赖本地 Git 配置，若
core.autocrlf或core.eol设置异常，可能导致行尾差异被放大，误判为大量修改
想对比两个任意提交之间的文件变化
GitHistory 原生不支持“选 A 提交 + 选 B 提交 → 对比”这种操作，它只支持单提交上下文浏览。真要对比，得绕一下。
最快方式是：先用 GitHistory 找到第一个提交哈希（比如 abc1234），再用 VSCode 内置的命令 Git: Compare HEAD with...，粘贴第二个哈希（如 def5678）；或者直接在终端运行 git diff abc1234 def5678 -- path/to/file，然后把输出拖进 VSCode 新建文本里看。
- 不要指望在 GitHistory 界面里拖拽或 Ctrl+Click 多选——它没这个交互逻辑
- 如果两个提交跨分支，确保本地已 fetch 远程，否则哈希可能解析失败，报错
fatal: bad revision 'xxx' - 对比大文件时，VSCode 内置 diff 会卡顿，这时用命令行
git diff --no-index或外部工具（如meld）更稳
历史记录里看不到刚 commit 的内容
不是插件延迟，而是 GitHistory 读取的是本地仓库状态，它不会自动刷新。你刚 git commit 完，插件界面还停留在旧快照。
手动刷新只有两个可靠动作：关掉当前 GitHistory 标签页，重新执行 Git History: View File History；或者在 GitHistory 页面右上角点那个带循环箭头的 Refresh 按钮（图标小，容易漏）。
- 别等它自动更新——它从不轮询，也不监听 fs 事件
- 如果刷新后仍缺失，检查
git status输出，确认 commit 确实写入了当前分支，而不是误提交到了分离头指针（detached HEAD）状态 - 某些 CI/CD 工具（如 GitHub Actions）生成的推送，若含 signed commit 或特殊 ref，也可能被 GitHistory 跳过，需查其日志输出中的
git log实际结果
GitHistory 是个轻量级视图工具，不是 Git 替代品。它不处理暂存、不干预工作区、也不缓存远程历史——所有数据都来自你本地 .git 目录的实时读取。一旦发现行为异常，第一反应不该是重装插件，而是打开终端跑一遍 git log --oneline -n 10 -- path/to/file，对照看输出是否一致。
