Git History插件不提供右键菜单入口，必须通过命令面板调用：Ctrl+Shift+P输入“Git History: Show File History”（VSCode 1.85+）或“Git: View File History”（旧版），且文件需已被git add跟踪；点提交后需手动切换至Diff标签查看改动，历史不自动刷新须点击Refresh。
Git History 插件装了但右键没反应？这是最常见卡点
Git History 不提供右键菜单入口，装完就右键找“Git History”必然失败。它只响应命令面板调用，不是所有插件都支持右键快捷方式。
- 必须按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Git History: View File History回车 - 前提是当前编辑器标签页已打开一个已被
git add过的文件（git status能列出它） - 如果命令搜不到，去扩展页确认
git-history（作者 donjayamanne）状态为“已启用”，不是禁用或灰色 - VSCode 1.85+ 版本中命令名可能缩写为
Git History: Show File History，搜不到原名时试试这个
点开某次提交后看不到 diff？别急着怀疑插件坏了
Git History 默认只显示提交元信息（作者、时间、message），不会自动展开代码差异。用户常误以为“点进去就该看到改了哪几行”，其实得手动再点一次。
- 进入提交详情页后，顶部有三个标签：
Overview、Files、Diff；真正看改动得点Diff标签 -
Files标签只列本次提交涉及的文件名，不展示内容变化 - 点
Diff后仍空白，大概率是：该文件在那次提交中是二进制（如图片）、被.gitattributes忽略、或当前工作区路径与仓库根目录不一致（比如你在子目录打开 VSCode，但.git在父目录） - 换行符配置异常（如
core.autocrlf=true）会导致 diff 渲染出大量虚假变更，临时把 VSCode 设置里files.eol设为\n可验证是否为此问题
想对比两个任意 commit？Git History 原生不支持多选对比
它只做单提交上下文浏览，没有“Ctrl+Click 选 A 和 B → 对比”这种交互逻辑。真要对比，得绕一下。
- 最快方式：先用 Git History 找到第一个 commit 的哈希（如
abc1234），再用 VSCode 内置命令Git: Compare with Revision粘贴第二个哈希（如def5678） - 或者直接终端执行：
git diff abc1234 def5678 -- path/to/file，输出可复制进 VSCode 新建文本查看 - 若两个 commit 跨分支，确保本地已运行
git fetch origin，否则哈希解析失败会报错fatal: bad revision 'xxx' - 对比大文件时，VSCode 内置 diff 易卡顿，这时用
git diff --no-index或外部工具（如meld）更稳
历史记录里看不到刚 commit 的？不是插件延迟，是 Git 状态没同步
Git History 依赖本地 Git 引用数据，它不自动监听 fs 事件刷新，也不会主动 git fetch 或 git pull。
- 刚
git commit完，历史面板不会自动更新，必须手动点击右上角Refresh按钮 - 如果是远程新提交（别人 push 的），需先在终端运行
git fetch origin，再点Refresh - 多根工作区（multi-root workspace）下，Git History 只对“活动的”仓库生效，焦点不在 Git 仓库根目录内时，历史为空是正常的
- 重命名或删除过的文件，Git History 仍能追踪（因底层用
git log --follow），但点旧路径提交时可能跳转失败——这不是 bug，是 Git 元数据和当前工作区路径不一致导致的
Git History 的核心限制在于：它不接管 Git 数据流，只是读取已有引用快照。任何“看不到”“点不开”“对比不了”的情况，几乎都源于本地 Git 状态未就绪，而非插件本身失效。
