git graph打不开或图为空，主因是vscode未识别git仓库：必须在含.git的根目录打开并正确配置git.path；默认只显示当前分支，需勾选show all branches并刷新才能看到完整拓扑。
Git Graph 打不开或图是空的，先确认仓库根目录和 git.path
90% 的“图没出来”问题，不是插件坏了，而是 VSCode 根本没识别到 Git 仓库。Git Graph 只在打开的文件夹里有 .git 目录时才激活——如果只打开了 src/ 或 packages/utils 这类子目录，它就静默失效。
快速验证：Ctrl+Shift+P → 输入 Git: Show Git Output，如果看到 fatal: not a git repository，说明路径错了。
- 最快修复：右键资源管理器里的项目文件夹 →
Reopen Folder as Root -
git.path必须指向真实可执行文件，比如/usr/bin/git（macOS/Linux）或C:\Program Files\Git\bin\git.exe（Windows）；配错会导致所有 Git 操作瘫痪 - 多根工作区下，Git Graph 只作用于第一个被识别为 Git 仓库的文件夹，不支持跨根聚合
分支图只显示一条直线？必须手动开 Show All Branches
刚把 feature/login 合入 main，图里却只剩一条竖线——这不是合并失败，是插件默认只画当前分支及其直系祖先链，所有已合入的 feature 分支指针都被隐藏了。
打开 Git Graph 视图（Ctrl+Shift+G），点右上角齿轮图标 → 勾选 Show All Branches，再点 Refresh 按钮强制重载。
- 此时所有本地分支会以带颜色圆点形式出现，箭头连接关系完整还原
-
merge commit显示为菱形，但 parent 顺序决定谁是“被合并方”：左边连的是第一个 parent（通常是main），右边连的是第二个 parent（如feature/x） -
git merge -s ours或 fast-forward 合并不会产生菱形节点——图里只有一条直线，这是 Git 本身没存第二 parent，不是插件 bug
远程分支、刚删的分支都看不到？得开 Show Remote Branches 和 Toggle Reflog
默认视图连 origin/develop 都不加载，更别说被 git branch -d 删掉的分支——它们不会自动消失，但也不会自动浮现。
- 勾选
Show Remote Branches，再点Refresh；若仍不显示，先在终端运行git fetch origin，否则远程引用根本没拉下来 - 要找回刚删的本地分支：点
Toggle Reflog，它能列出最近 30 天内被删除的分支头（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 -
--simplify-by-decoration是关键：它确保HEAD、origin/main等关键指针被渲染出来；光靠-n 200不够，没这个参数照样漏分支
Git 分支图不是“画出来好看就行”，它得和 git log --graph --all --simplify-by-decoration 输出严格一致。很多人调了半天配色和布局，却漏掉这两个底层开关，结果图看着对，其实缺了关键分支指针。
