git graph 插件打不开主因是vscode未打开git仓库根目录；分支线混乱可通过focus on branch或过滤提交优化；提交详情不显示diff需手动比较；导出推荐html而非截图。
Git Graph 插件打不开，点开就报 Unable to load repository
这通常不是插件坏了，而是 VSCode 没识别到 Git 仓库根目录。Git Graph 只在打开的文件夹是 Git 仓库（即存在 .git 目录）时才激活。如果只是打开了某个子文件夹（比如 src/ 或 packages/utils），它就找不到 .git，直接静默失效。
- 确认当前 VSCode 窗口打开的是仓库根目录：检查资源管理器顶部路径，或执行
git rev-parse --show-toplevel看输出是否匹配 - 如果用的是多根工作区，确保至少一个文件夹是完整 Git 仓库；Git Graph 不支持跨根仓库聚合视图
- Windows 上路径含中文或空格一般不影响，但某些杀毒软件会拦截
.git/objects访问，导致加载失败——可临时禁用试试
分支线一团乱，看不到清晰的合并关系
默认视图会把所有分支、标签、甚至 detached HEAD 都铺开，线条交叉严重。这不是数据错，是显示策略问题：Git Graph 默认按提交时间线性排列，不强制“合并线居中”或“主干靠左”。
- 右键点击任意提交 → 选择
Focus on Branch，输入main或develop，视图立刻收拢到该分支及其直接祖先/后代 - 点击右上角
⋯→Filter Commits→ 勾选Only show commits that are referenced by at least one branch or tag，过滤掉孤立提交和已删分支残留 - 合并提交（merge commit）默认带
∨图标，但若你用git merge --squash，它就变成普通提交，不会显示为合并点——这是 Git 语义决定的，插件无法“脑补”
点开某个提交看不到 diff，或者文件列表为空
Git Graph 的提交详情页只展示该提交的变更文件列表（paths），不内嵌 diff 内容。它本质是个图形化日志浏览器，不是代码比对工具。
- 点击文件名右侧的
...→ 选Open File in Editor，才能看到当前版本内容；想看变更，得手动右键 →Compare with Previous Commit - 如果文件列表为空，大概率是这个提交是空提交（
git commit --allow-empty），或该提交只有 submodule 更新（Git Graph 默认不展开 submodule diff） - 注意：它不读取
.gitattributes或core.autocrlf设置，所以换行符差异、二进制文件标记等不会影响显示逻辑
想导出图片或分享当前视图给同事
Git Graph 没有内置导出 PNG 功能，但有更实用的替代方案：生成可交互的静态 HTML 报告。
- 右上角
⋯→Export Graph as HTML File，生成一个单文件 HTML，双击即可用浏览器打开，支持缩放、搜索、点击跳转 - 导出的 HTML 不依赖网络，但会包含全部提交哈希和作者信息——敏感项目导出前建议先清理本地提交记录（如用
git filter-repo） - 别用截图！因为分支名过长时会被截断，且缩放后文字模糊；HTML 方案能保留所有交互能力，对方也能 Ctrl+F 搜关键词
Focus on Branch 和 Export as HTML 这两个动作，日常查合并冲突、回溯发布节点、向新人解释分支模型，效率会明显不一样。真正容易卡住的，其实是误以为它能替代 git log --graph 的定制能力——它不能，也不该替代。
