git graph 仅可视化不执行合并，真正合并需在vscode源代码管理面板中检出目标分支后操作；图为空多因路径或git.path配置错误，须确保打开仓库根目录并正确配置git路径；默认只显示当前分支，需手动开启show all branches才能看到所有分支及合并关系；合并提交以菱形表示，右侧箭头指向被合并分支，严格反映git对象结构。
Git Graph 插件本身不执行合并，只可视化；真正合并必须通过 VSCode 源代码管理面板触发，且必须先检出目标分支。
Git Graph 打不开或图是空的，90% 是路径或 git.path 配置问题
它只在 .git 所在的根目录下工作，子文件夹里打开会静默失败。验证方法：命令面板（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 Graph 不聚合多个仓库，只作用于第一个有效仓库
为什么图里只有一条线？必须手动开启 Show All Branches
默认只显示当前分支及其直系祖先，其他分支（包括刚合入的 feature/login）完全不可见。这不是数据丢失，是视图过滤策略。
- 打开 Git Graph 视图（
Ctrl+Shift+G） - 点右上角齿轮图标 → 勾选
Show All Branches - 点
Refresh按钮强制重载 - 此时所有本地分支以不同颜色圆点呈现，合并箭头也完整还原
“一键合并”实际路径：源代码管理面板 + 正确检出顺序
Git Graph 右键分支没有 Merge 选项——它不是操作入口。所谓“图形化合并”，本质是用图形确认拓扑，再切到源代码管理面板执行。
- 先在 Git Graph 中确认目标分支（如
main）和待合入分支（如feature/x）的相对位置和共同祖先 - 在源代码管理面板（左侧
Ctrl+Shift+G图标）中，确保状态栏显示你已检出main - 点右上角
⋯→Merge Branch→ 选择feature/x - 合并后 Git Graph 不自动刷新，必须手动点
Refresh或重新打开视图
合并提交显示为菱形，但 parent 顺序决定语义
图中菱形节点只是 merge commit 的视觉标记，关键看两个 parent 的指向：
- 左边箭头连向第一个 parent（通常是当前分支，如
main） - 右边箭头连向第二个 parent（被合并进来的分支，如
feature/x） -
git merge --no-ff feature/x一定生成菱形，右侧连feature/x最新提交 -
git merge --ff-only或git merge --squash不会产生菱形，图里就是直线或普通提交节点
图形不会“脑补”语义，它严格反映 Git 对象结构。想看清谁合进了谁，盯紧菱形右侧那条线。
