VSCode需手动触发Git提交历史视图，且默认不显示合并提交；启用Show Merge Commits、确认Git扩展启用、检查仓库根目录及reflog大小可解决常见问题。
VSCode 本身不自动显示 Git 提交历史，必须手动触发；图形化视图不是默认打开的，也不是点开源代码管理就能看到的。
View Commit History 菜单点不出来？先确认三件事
按 Ctrl+Shift+G（Windows/Linux）或 Cmd+Shift+G（macOS）打开源代码管理侧边栏后，顶部 ⋯ 菜单里没有 View Commit History，大概率是以下任一原因：
- 当前文件夹下没有
.git目录（即未初始化仓库或路径不对） - VSCode 的内置 Git 扩展被禁用（去扩展页搜
Git，确认官方Git扩展状态为“已启用”） - 工作区是多根工作区（multi-root workspace），且当前焦点不在 Git 仓库根目录内——VSCode 只对“活动的”仓库提供 Git 功能入口
想看分支合并图？必须打开 Show Merge Commits
VSCode 默认隐藏 merge commit，导致图形视图里分支线突然中断、看不出 feature 是何时合入 main 的。这不是 bug，是默认行为。
解决方法很简单：在图形化历史视图右上角，找到齿轮图标 → 勾选 Show Merge Commits。勾选后你会看到带斜线连接的菱形节点，不同分支线也有了颜色区分。
注意：View Commit History 默认只展示当前检出分支；要看所有分支，得在右上角搜索框里输 --all，或者直接用命令面板运行 Git: View Branch History（它默认含 --all）。
点提交后 diff 为空或跳错文件？常见于重命名/删除/路径含空格
点击某次提交后，右侧 diff 区域空白、卡住，或跳转到一个根本不存在的路径，通常不是 VSCode 崩溃，而是 Git 元数据和当前工作区状态不一致：
- 该提交中文件已被重命名或删除，VSCode 尝试解析旧路径失败
- 路径含 Unicode 字符或空格，Git 内部引用正常，但 VSCode 的 diff 渲染器没正确 decode
- 该提交是 merge commit，而 VSCode 默认只显示 conflict resolution 部分，不展开两个 parent 的全部变更
临时绕过方式：右键该提交 → Copy SHA，然后终端执行 git show <sha> -- path/to/file 查原始 diff。
图形视图变慢甚至白屏？先查 .git/logs/refs/heads/ 大小
VSCode 图形化历史依赖 reflog 构建可视化结构。如果项目长期未清理（比如 CI 频繁推送、本地反复 checkout/rebase），.git/logs/refs/heads/ 下的文件可能膨胀到几 MB，直接拖慢渲染速度。
可快速验证：du -sh .git/logs/refs/heads/。若超过 2MB，建议：
- 运行
git reflog expire --expire=30.days.ago --all清理旧记录 - 或临时禁用 reflog：在仓库根目录执行
git config core.logAllRefUpdates false（不影响功能，仅关闭 reflog 记录） - 大仓库（>10 万提交）别硬扛图形视图，直接终端跑
git log --graph --all --oneline --simplify-by-decoration，更快更稳
图形视图本质是 convenience layer，不是 source of truth；关键判断（比如 merge base、rebase 范围）仍应以 git merge-base 或 git log --cherry-pick 为准。
