VSCode怎么使用Git Graph插件查看分支合并树状图

Git Graph不显示分支图？先别急着卸插件，绝大多数情况下，问题出在两个非常基础的环节：你打开的位置对不对，以及VSCode有没有找到那个Git的可执行文件。

首先，插件只在.git所在的那个根目录下干活。你在文件夹里点开Git Graph却毫无动静，很可能就是路径不对。验证起来很简单：命令面板里输Git: Show Git Output，如果输出框里跳出fatal: not a git repository，那就是当前路径根本不是一个Git仓库。解决办法也干脆，右键资源管理器里的文件夹，选Reopen Folder as Root，这就能最快搞定。

另一种常见的情况是git.path配乱了。进VSCode设置搜这个字段，看看它指向的Git二进制文件是否正确。比如macOS或Linux上是/usr/bin/git，Windows上是C:\Program Files\Git\bin\git.exe。路径写错会导致所有Git操作都瘫痪，图自然一片空白。

分支图只显示一条直线？看看是不是忘了勾选“Show All Branches”

刚把feature/login合并到main，图里却只剩一条直线——这不是合并失败，而是Git Graph默认只展示当前分支以及它的直系祖先。那些已经合并进来的特性分支，指针被完全隐藏了。

解决起来很简单，记住一句话：打开Git Graph视图，点右上角那个齿轮图标，勾上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合并，就不会产生菱形——图里仍然是一条直线，这不是插件bug，而是Git本身没存第二个parent。

拿不准的时候，直接右键那个节点，选View Commit Details，看看parent字段里的hash列表，这比看图更准确。

大仓库加载卡顿、图太乱？关闭自动刷新再加上参数限深

如果你的仓库提交数超过一万，开启了Auto Refresh会让VSCode主进程卡住好几秒。正确操作是：设置里关掉Auto Refresh，改用Refresh手动触发。然后在图形界面的输入框里粘贴一串参数：--all --simplify-by-decoration --date-order -n 200。

这个组合效果很好：跳过大量没有tag或branch标记的中间merge，只拉取最近200条关键提交，图立刻干净，而且分支拓扑关系不丢失。其中最容易遗漏的是--simplify-by-decoration——它不是控制数量，而是控制哪些提交有资格出现在图上。没有了它，分支图就不是真正意义上的分支图，只是一个局部提交快照。