git graph 打不开主因是 vscode 未识别 git 仓库：需确认在根目录打开项目、正确配置 git.path；分支图仅显示当前分支直系祖先，须勾选 show all branches；merge commit 菱形节点右侧 parent 为被合并分支；大仓库应禁用 auto refresh 并用 --all --simplify-by-decoration -n 200 限深优化。
Git Graph 插件根本打不开？先验证仓库和 Git 路径
插件没反应，90% 是 VSCode 根本没识别到 Git 仓库。别急着调设置，先做两件事：Ctrl+Shift+P → 输入 Git: Show Git Output，如果看到 fatal: not a git repository，说明你当前打开的是子文件夹，不是仓库根目录。
- 右键资源管理器里的项目文件夹 →
Reopen Folder as Root - 进 VSCode 设置搜
git.path，必须指向真实可执行文件，比如/usr/bin/git（macOS/Linux）或C:\Program Files\Git\bin\git.exe（Windows） - 多根工作区下，Git Graph 只作用于第一个被识别为 Git 仓库的文件夹，不支持跨根聚合
分支图只显示一条直线？必须开 Show All Branches
默认视图只画当前分支及其直系祖先，所有已合入的 feature/login、develop 等分支指针全被隐藏——这不是合并失败，是插件默认行为。
- 打开 Git Graph 视图（
Ctrl+Shift+G） - 点右上角齿轮图标 → 勾选
Show All Branches - 点
Refresh按钮强制重载 - 此时所有本地分支以带颜色圆点出现，merge commit 显示为菱形，箭头连接关系完整还原
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 秒，且默认全量拉取会让分支线交叉成毛线团。
- 进 Git Graph 设置 → 关闭
Auto Refresh，改用右上角Refresh按需更新 - 在图形界面顶部输入框加限制参数：
--all --simplify-by-decoration --date-order -n 200 - 这会只拉最近 200 条有 tag/branch 标记的提交，跳过大量中间 merge，图立刻变干净，且不丢分支拓扑关系
- 漏掉
--all或--simplify-by-decoration，图看着对，其实缺了关键分支指针
git log --graph --all --simplify-by-decoration 输出严格一致——参数错一个，拓扑就丢一分。
