git graph打不开或图为空，先确认在.git根目录打开且git.path配置正确；默认只显示当前分支，需勾选show all branches并刷新才能看到完整分支拓扑。
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 默认只画当前分支的直系祖先链，其他分支指针（包括已合入的 feature）被完全隐藏。
解决办法极简：
- 打开 Git Graph 视图（
Ctrl+Shift+G） - 点右上角齿轮图标 → 勾选
Show All Branches - 点
Refresh按钮强制重载
此时所有本地分支都会以带颜色的圆点形式出现，箭头连接关系也还原真实 DAG 结构。漏掉这一步，你永远看不到真实的分支拓扑。
远程分支、刚删的分支都看不到？得手动开 Remote Branches 和 Reflog
默认视图连 origin/develop 都不加载，更别说被 git branch -d 删除的分支——它们不会自动消失，但也不会自动浮现。
要看到远程分支：
- 点右上角
⋯→ 勾选Show Remote Branches→ 点Refresh
要找回最近删掉的本地分支（30 天内）：
- 点
⋯→Toggle Reflog，它会列出 reflog 记录里的分支头
注意：某些私有 Git 服务器（如自建 GitLab）可能禁用 ls-remote，导致远程分支加载失败；可在终端运行 git ls-remote --heads origin 验证连通性。
大仓库卡顿、图乱、加载慢？关 Auto Refresh + 加过滤参数
超过 10k 提交的仓库，开启 Auto Refresh 会让 VSCode 主进程卡死 3–5 秒，且图越画越乱。
推荐做法：
- 进 Git Graph 设置 → 关掉
Auto Refresh，改用右上角手动Refresh - 在图形界面顶部输入框里加参数：
--all --simplify-by-decoration --date-order -n 200
这个组合只拉最近 200 条带 branch/tag 标记的提交，跳过大量中间 merge，拓扑关系不丢，图立刻干净。注意：--all 和 --simplify-by-decoration 缺一不可，漏掉一个，分支指针就可能“隐身”。
最常被忽略的一点：Git Graph 不是开箱即用的“一键可视化”，它对仓库结构、Git 配置、VSCode 环境高度敏感。哪怕只是多了一层目录嵌套，或 git.path 指向了假路径，整个图就会彻底静默失效——它不报错，也不提示，只留一片空白。
