git history 插件无右键菜单，所有操作需通过命令面板调用，且文件必须已被 git add 跟踪、工作区根目录存在 .git、扩展已启用；提交详情中 diff 为空需手动点开并检查文件状态、换行符配置及是否为二进制文件。
Git History 插件装了但右键没反应？不是插件坏了，是它根本没右键入口——所有操作必须走命令面板，且文件必须已被 git add 跟踪。
为什么 Git History 命令搜不到或点不开
插件不注入右键菜单到编辑器区域，只响应命令面板调用；常见卡点是路径、状态、命令名三者不匹配。
- 必须按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Git History: Show File History（VSCode 1.85+）或Git: View File History（旧版），不能靠右键试探 - 当前打开的文件必须已在 Git 索引中：运行
git status能列出它，未add的新文件、未保存的临时文件均不可触发 - 检查扩展页中
donjayamanne.githistory是否为“已启用”状态，灰色或禁用即无效 - 工作区根目录下必须存在
.git/，若在子目录打开 VSCode（如project/src/），而.git在project/，则插件无法定位仓库
点了提交却看不到代码改动（Diff 为空）
Git History 默认只展示提交元信息（作者、时间、message），Diff 标签需手动点击加载，且内容是否渲染成功取决于文件状态与 Git 配置。
- 进入提交详情页后，顶部有三个标签：
Overview、Files、Diff；真正看代码变更必须点开Diff -
Files标签只列本次提交涉及的文件名，若该文件不在其中，Diff必然空白 - 二进制文件（如图片、PDF）、被
.gitattributes设置为diff=none的文件、或行尾配置异常（如core.autocrlf=true导致大量虚假换行差异）都会使Diff渲染失败 - 临时验证是否为换行符问题：在 VSCode 设置中将
files.eol改为\n，再刷新
想对比两个任意 commit？Git History 不支持直接双选
它的交互模型是单提交上下文浏览，没有 Ctrl+Click 多选逻辑。真要对比，得借力 VSCode 内置命令或终端。
- 最快方式：在 Git History 中复制第一个 commit 的哈希（如
abc1234），再执行 VSCode 命令Git: Compare with Revision，粘贴第二个哈希（如def5678） - 跨分支对比前，务必先运行
git fetch origin，否则哈希解析失败会报fatal: bad revision 'xxx' - 大文件 diff 卡顿？VSCode 内置 diff 易阻塞，改用终端命令：
git diff abc1234 def5678 -- path/to/file，输出可拖进新文本查看 - 不要尝试在 Git History 界面里拖拽、多选或右键“Compare”——它没实现这些交互
刚 commit 完却没出现在历史里
不是插件延迟，是 VSCode 没感知到 Git 状态更新。它依赖本地 reflog 和索引快照，不会自动轮询。
- 手动刷新：执行命令
Git: Refresh Status，或关闭再重新打开工作区文件夹 - 确保
git.enabled设置为true，且状态栏显示当前分支名（如main），否则内置 Git 功能可能被静默禁用 - 若使用稀疏检出（
core.sparseCheckout=true）或部分克隆（clone --filter），Git History 可能无法读取完整提交链，建议临时关闭：git config core.sparseCheckout false
