git graph打不开或图为空，先确认在.git根目录打开且git.path配置正确；默认只显示当前分支，需勾选show all branches并刷新才能看到完整分支拓扑。
Git Graph 打不开或图是空的，先检查仓库根目录和 git.path
插件根本没反应，90% 是 VSCode 没识别到 Git 仓库。它只在 .git 所在的根目录下工作，子文件夹里点开 Git Graph: View Git Graph 会静默失败。
立刻验证方法：命令面板（Ctrl+Shift+P）→ 输入 Git: Show Git Output，如果看到 fatal: not a git repository，说明当前路径不对。右键资源管理器中的文件夹 → Reopen Folder as Root 最快解决。
另一个常见断点是 git.path 配置错误。进 VSCode 设置搜 git.path，必须指向真实可执行的 Git 二进制文件，比如：
-
/usr/bin/git（macOS/Linux） -
C:\Program Files\Git\bin\git.exe（Windows）
配错会导致所有 Git 操作瘫痪，图自然出不来。
分支图只显示一条直线？必须手动开启 Show All Branches
刚合并完 feature/login 到 main，图里却只剩一条线——不是没合并，是 Git Graph 默认只画当前分支及其直系祖先。其他分支指针（包括已合入的 feature）被完全隐藏。
解决办法极简：
- 打开 Git Graph 视图（快捷键
Ctrl+Shift+G） - 点右上角齿轮图标 → 勾选
Show All Branches - 点
Refresh按钮强制重载
此时所有本地分支都会以带颜色的圆点形式出现在图中，箭头连接关系也完整还原。漏掉这一步，你永远看不到真实的分支拓扑。
merge commit 显示为菱形，但 parent 顺序决定谁是“被合并方”
图中菱形节点 ≠ 合并成功，它只是 Git 提交记录的可视化表达。关键看 parent 顺序：
- 左边箭头指向第一个 parent（通常是当前分支，如
main） - 右边箭头指向第二个 parent（被合并进来的分支，如
feature/x）
所以 git merge --no-ff feature/x 生成的菱形，右侧一定连着 feature/x 的最新提交；但 git merge -s ours 或 fast-forward 合并不会产生菱形——图里只有一条直线，这是 Git 本身没存第二 parent，不是插件 bug。
不确定时，右键该节点 → View Commit Details，直接看 parent 字段的 hash 列表，比图更准。
大仓库加载卡顿、图太乱？关 Auto Refresh + 加参数限深
超过 10k 提交的仓库，开启 Auto Refresh 会让 VSCode 主进程卡住 3–5 秒。正确姿势是：
- 设置里关闭
Auto Refresh，改用手动Refresh - 在图形界面顶部输入框里粘贴参数：
--all --simplify-by-decoration --date-order -n 200
这个组合效果最实：跳过大量无 tag/无 branch 标记的中间 merge，只拉最近 200 条关键提交，图立刻干净，且分支拓扑关系不丢。漏掉 --simplify-by-decoration，图里就缺 HEAD、origin/main 这些指针，等于白看。
真正容易被忽略的，是那个 --simplify-by-decoration ——它不控制数量，而控制“哪些提交有资格出现在图上”。没有它，分支图就不是分支图，只是个局部提交快照。
