git graph是vscode中唯一不依赖webview、能准确还原git dag结构且大仓库不卡顿的图形化方案；需确保打开.git根目录、正确配置git.path、启用show all branches等关键设置，否则90%功能无效。
直接用 Git Graph 扩展——它是目前 VSCode 中唯一不依赖 Webview、能准确还原 Git DAG 结构、支持右键操作且大仓库不卡顿的图形化方案。装完不配置，90% 功能等于没开。
Git Graph 打不开？先验证三件事
插件静默失败，几乎全是环境没对齐：
- 当前打开的文件夹必须是
.git所在根目录；子目录里点Git Graph: View Git Graph不报错也不显示，直接无效 -
git.path设置必须指向真实可执行的 Git 二进制（如/usr/bin/git或C:\Program Files\Git\bin\git.exe）；否则所有操作都 fallback 到失败 - 运行命令面板
Git: Show Git Output，看输出里有没有fatal: not a git repository—— 有就说明 VSCode 根本没识别到仓库
分支图里只有一条线？缺了关键开关
默认视图只渲染当前分支及其直系祖先，feature 分支合并后“消失”不是 bug，是默认行为：
- 点击图形界面右上角齿轮图标 → 勾选
Show All Branches，再点Refresh - 要看到
origin/develop这类远程分支，还得额外勾选Show Remote Branches - 刚删掉的本地分支不会立刻消失；点右上角
⋯ → Toggle Reflog，能找回最近 30 天内被删的分支头
大仓库卡死、图乱、加载慢？别等 Auto Refresh
超 10k 提交的仓库，开启 Auto Refresh 会让 VSCode 主进程卡住 3–5 秒，且越刷越糊：
- 进
Git Graph设置 → 关掉Auto Refresh，改用右上角手动Refresh - 在图形界面顶部输入框里粘贴：
--all --simplify-by-decoration --date-order -n 200 -
--all和--simplify-by-decoration缺一不可：漏掉前者，远程/未追踪分支不出现；漏掉后者，分支指针“隐身”，图里只剩光秃秃的提交线
merge commit 显示为菱形，但 parent 顺序决定你能不能看懂
菱形节点只表示 Git 记录了两个 parent，不代表一定成功合并：
- 左向箭头是第一个 parent（通常是当前分支 HEAD），右向箭头是第二个 parent（被合并分支）
-
git merge --no-ff feature/x必然生成菱形；git merge -s ours或 fast-forward 合并则不会——图里只有一条线，不等于没合并 - 不确定 parent 是谁？右键该菱形节点 →
View Commit Details，直接看原始parenthash 列表
Git Graph 的图不是“画出来好看就行”，它底层调用的就是 git log --graph，输出必须和 git log --graph --all --simplify-by-decoration 严格一致。很多人调了半天颜色和布局，却漏掉这两个参数，结果分支指针明明存在，图里就是不显示。
