Git Graph 默认不显示远程分支，因未执行 git fetch 且未启用 showRemoteBranches；merge 节点缺失多因未开 Show All Branches 或未用 --simplify-by-decoration 参数精简拓扑。
Git Graph 插件能清晰展示分支合并关系、提交拓扑和时间流向，但默认配置下容易漏掉远程分支、merge 节点或关键指针——这不是插件问题，是 Git 引用未加载或参数没配对。
为什么打开 Git Graph 看不到 origin/main 或其他远程分支
Git Graph 默认只显示本地已知引用，git fetch 没执行过，远程分支就不会出现在图中。右键任意节点点 View Commit Details 也查不到 origin/main 的哈希，因为根本没拉下来。
- 先在 VSCode 终端运行
git fetch --all（或至少git fetch origin） - 再点 Git Graph 右上角的
Refresh按钮（不是等 Auto Refresh） - 如果仍不显示，检查设置里
git-graph.showRemoteBranches是否为true；VSCode 设置搜索该关键词直接修改 - 注意：即使设置了显示远程分支，
origin/HEAD这类符号引用也不会渲染成节点，它只是指向origin/main的别名
merge commit 显示为直线，不是菱形？
这说明那次 merge 是 fast-forward 类型，Git 没生成新 commit，图里自然没有菱形节点。但如果你用了 git merge --no-ff 却还是直线，大概率是 Show All Branches 没开，或者当前视图被 Filter 锁死了范围。
- 点右上角齿轮 → 勾选
Show All Branches（不是仅当前分支） - 顶部 Filter 按钮旁确认是否写着 “All Branches”；若显示 “Filtered”，点进去清空筛选
- 菱形节点的左右 parent 顺序固定：
git merge feature/x后，左侧是 main 当前 HEAD，右侧才是feature/x的 tip —— 这个方向不能靠颜色判断，得看箭头指向 - 用
git cat-file -p <commit-hash>手动验证 parent 数量，两个 parent 才是真正的 merge commit
大仓库卡顿、加载慢、图谱杂乱
超过 10k 提交的仓库，开 Auto Refresh 会让 VSCode 主进程卡住几秒；全量 --all 会把所有无 tag/无 branch 的中间 merge 都画出来，分支线缠成一团。
- 设置 → 关闭
git-graph.autoRefresh - 手动 Refresh 前，在图顶部输入框加参数：
--all --simplify-by-decoration --date-order -n 200 - 必须带
--simplify-by-decoration，否则HEAD、origin/main这些关键指针不会渲染，看着分支连上了，其实远程引用根本没画出来 - 不要依赖
Max Commits to Load配置项，它只限制数量，不控制拓扑精简；真正起效的是命令行参数里的--simplify-by-decoration
点了 commit 却看不到变更文件列表
Git Graph 默认只加载元信息（author、message、time），Files Changed 是按需加载的独立面板，不点开就不会出现。
- 单击某个 commit 节点后，右侧面板默认是
Details标签页；切换到Files Changed才能看到修改文件 - 如果文件列表为空或显示
Unable to load file changes，通常是该 commit 包含二进制文件或超大文件，可右键对应文件 →View File at Commit直接打开快照 - merge commit 的 diff 默认只显示冲突解决部分，不是两个 parent 的全部差异；要看完整变化，得用命令行：
git diff <parent1> <parent2>
最容易被忽略的其实是 --simplify-by-decoration 这个参数——它不控制数量，却决定哪些 commit 有资格出现在图中；漏掉它，整个图就失去了“锚点”，只剩一堆孤立的线。
