git graph 打不开或图为空，需确认仓库根目录和 git.path 配置正确；分支图仅一条直线是因未启用 show all branches；远程分支需勾选 show remote branches 并执行 git fetch；删掉的分支可通过 toggle reflog 查看；大仓库应关闭 auto refresh 并使用 --simplify-by-decoration 等参数优化显示。
Git Graph 打不开或图是空的，先确认仓库根目录和 git.path
90% 的“打不开”问题，根源是 VSCode 没识别到 Git 仓库。Git Graph 只在 .git 所在的根目录下工作，子文件夹里点开视图会静默失败。
立刻验证：按 Ctrl+Shift+P → 输入 Git: Show Git Output，如果输出里有 fatal: not a git repository，说明路径错了。
最快修复：右键资源管理器中的项目文件夹 → Reopen Folder as Root。
另一个硬性依赖：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 默认隐藏所有非当前分支的指针。merge commit 节点存在，但它的右 parent（即被合并的分支）根本没画出来。
解决办法极简：
- 打开 Git Graph 视图（快捷键
Ctrl+Shift+G） - 点右上角齿轮图标 → 勾选
Show All Branches - 点
Refresh按钮强制重载
此时所有本地分支都会以带颜色的圆点形式出现，箭头连接关系也还原了真实 DAG 结构。
想看 origin/develop 或刚删的分支？还得开 Remote Branches 和 Reflog
默认视图连 origin/develop 都不加载，更别说被 git branch -d 删掉的分支——它们不会自动消失，但也不会自动浮现。
要显示远程分支：
- 勾选
Show Remote Branches，再点Refresh - 若仍不显示，先在终端运行
git fetch origin，否则远程引用根本没拉下来
要找回刚删的本地分支：
- 点右上角
⋯→Toggle Reflog，它能列出最近 30 天内被删除的分支头 - 某些私有 Git 服务器（如自建 GitLab）可能禁用
ls-remote，可在终端手动运行git ls-remote --heads origin验证连通性
大仓库卡顿、图太密看不清？关 Auto Refresh + 加限制参数
超过 10k 提交的仓库，开启 Auto Refresh 会让 VSCode 主进程卡住几秒；而默认拉全量提交，图中全是密密麻麻的 merge 线，关键分支走向反而被淹没。
推荐做法：
- 进 Git Graph 设置 → 关闭
Auto Refresh，改用手动Refresh - 在图形界面顶部输入框里加参数：
--all --simplify-by-decoration --date-order -n 200 - 必须带
--simplify-by-decoration，否则HEAD、origin/main这些关键指针不会渲染
注意：Max Commits to Load 配置项只限制数量，不控制拓扑精简；真正起效的是命令行参数里的 --simplify-by-decoration。
