git graph 插件打不开或图为空，90%因路径或git.path配置错误；需确保打开仓库根目录、正确设置git.path、多根工作区仅首仓生效、勾选show all branches显示所有分支、菱形节点右侧箭头指向被合并分支、关闭auto refresh并过滤提交以优化大仓库性能。
Git Graph 插件打不开或图是空的，90% 是路径或 git.path 配错了
VSCode 识别不到 Git 仓库时，Git Graph 直接静默失效，不会报错也不会提示。最常见的情况是你打开的不是仓库根目录（比如只打开了 src/ 或 packages/utils），导致插件找不到 .git 目录。
快速验证方法：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Git: Show Git Output，如果看到 fatal: not a git repository，说明当前工作区无效。
- 右键资源管理器里的项目文件夹 → Reopen Folder as Root（最快解决）
- 进设置搜
git.path，必须指向真实可执行文件，例如：/usr/bin/git（macOS/Linux）或C:\Program Files\Git\bin\git.exe（Windows） - 多根工作区下，
Git Graph只作用于第一个被识别为 Git 仓库的文件夹，不支持跨根聚合
分支图只显示一条直线？必须手动开 Show All Branches
刚把 feature/login 合入 main，图里却只剩一条线——这不是合并失败，是插件默认只画当前分支及其直系祖先。所有已合入的 feature 分支指针都被隐藏了。
- 打开
Git Graph视图（Ctrl+Shift+G） - 点右上角齿轮图标 → 勾选
Show All Branches - 点
Refresh按钮强制重载
此时所有本地分支会以带颜色圆点形式出现，箭头连接关系完整还原；merge commit 显示为菱形，但 parent 顺序决定谁是“被合并方”。
merge 提交显示为菱形，但右侧连线不一定代表“被合并分支”
图中菱形节点 ≠ 合并成功，它只是 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 - 右上角 ⋯ →
Filter Commits→ 勾选Only show commits that are referenced by at least one branch or tag，过滤掉孤立提交和已删分支残留 - 右键任意提交 →
Focus on Branch，输入main或develop，视图立刻收拢到该分支及其直接祖先/后代
真正容易被忽略的是：Git Graph 不读取 .git/config 里的 log.graph 设置，也不受 git config --global log.abbrevCommit false 影响——它的图完全基于 git log --graph --all --simplify-by-decoration 的原始输出，任何“看起来不像”的偏差，都该先去终端跑这句命令比对。
