git graph 是 vscode 中查看提交历史和分支树的事实标准，因其渲染稳定、右键操作直接、merge commit 显示准确且支持大仓库性能优化；而内置 git: view history 默认仅线性展示当前分支、隐藏 merge 节点、依赖易卡顿的 reflog，功能与可靠性均不足。
Git Graph 插件是目前在 VSCode 里看提交历史和分支树最清晰、最可靠的选择，不是“可选”，而是“事实标准”——它不依赖 Webview、渲染稳定、右键操作直接、merge commit 节点准确，且对大仓库有明确的性能控制手段。
为什么内置 Git: View History 不够用
VSCode 1.80+ 确实自带 Git: View History，但它默认只展示当前分支的线性历史；合并节点（merge commit）被隐藏，除非手动勾选 Show Merge Commits；--all 参数不默认启用，远程分支、已删分支、tag 位置都可能缺失；更关键的是，它底层依赖 reflog 渲染，.git/logs/refs/heads/ 超过 2MB 就明显卡顿甚至白屏。
- 点开提交后 diff 为空？大概率是该提交为 merge commit，而内置视图只显示 conflict resolution 部分，不展开两个 parent 的变更
- 分支线突然中断、看不出 feature 是何时合入 main？不是数据丢了，是
Show Merge Commits没开 - 想查某次发布对应哪个 commit，但 tag 没标在图形上？需额外启用
Show Tags，且 tag 必须已推送到远程或本地存在
Git Graph 怎么装和启动才不踩坑
装错版本或路径不对，插件就等于没装。必须确认三点：
- 在扩展市场搜
Git Graph，作者必须是mhutchie（其他同名插件多为 fork 或已弃用） - 安装后不要只点状态栏图标——它有时不响应；应按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Git Graph: View Git Graph并回车 - 如果命令面板里搜不到该命令，先运行
Git: Show Git Output，看输出里有没有fatal: not a git repository——说明 VSCode 没识别到.git目录，得确认当前打开的是仓库根目录，不是子文件夹
打开后第一件事：调关键开关
刚打开 Git Graph 默认视图，90% 的人会误以为“分支没显示全”或“合并没成功”。其实只是几个开关没开：
- 右上角齿轮图标 → 勾选
Show All Branches：否则只显示当前检出分支及其直系祖先，feature 分支合入后就“消失” - 同样位置 → 勾选
Show Remote Branches：否则origin/main这类远程分支不会出现 - 勾选
Show Merge Commits：merge commit 显示为菱形节点，左 parent 是当前分支头，右 parent 是被合并分支头（如git merge --no-ff feature/login） - 顶部搜索框里加参数：
--all --simplify-by-decoration --date-order -n 200：避免加载全部提交拖垮界面，同时保留 tag/branch 标记的关键节点
点提交后看不到 diff？别急着重装
点击某个提交节点，右侧详情区默认只列文件名，diff 内容是折叠的，而且有三类常见失效场景：
- 没点开
Changes in Commit区域右侧的 ▶：这个区域默认收起，要手动展开才能看到文件列表；再逐个点击文件名，才会在下方显示 diff - 该提交是 merge commit，且你正查看的是其“父提交之一”：Git Graph 默认只显示该 merge 的“两路合并结果”，不自动对比两个 parent。此时右键该节点 →
Compare with Parent #1或#2才能看到完整差异 - 文件路径含空格或 Unicode 字符：VSCode 渲染器 decode 失败，diff 区域空白。临时解法：右键提交 →
Copy SHA，终端执行git show <sha> -- path/to/file</sha>
复杂点在于：图形视图的“所见即所得”高度依赖本地 Git 状态一致性。比如刚执行完 git rebase -i 但没 push，远程和本地 commit hash 已不一致，Git Graph 可能无法关联原始分支指针，导致部分节点孤立显示——这时候切终端跑 git log --graph --all 反而更快、更准。
