如何通过Git Graph插件在VSCode中查看分支合并的树状图？

本文共计908个文字，预计阅读时间需要4分钟。

插件基本没有反应，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 ——它不控制数量，而控制“哪些提交有资格出现在图上”。没有它，分支图就不是分支图，只是个局部提交快照。