git: view history 正常工作需满足三条件：.git 在工作区根目录、git.enabled 为 true、项目非符号链接打开；默认不显示图形分支图、不展开 diff、不保证所有提交可见。
Git: View History 能直接打开仓库级提交日志，但默认不显示图形分支图、不自动展开差异、也不保证所有提交都可见——它只在满足三个硬性条件时才正常工作。
点 Git: View History 没反应？先检查这三件事
这不是插件问题，是 VSCode 拒绝加载的明确信号：
-
.git目录必须存在于当前工作区根目录下；git init没执行或打开路径错了都会失败 -
git.enabled设置必须为true（在设置中搜该关键词即可确认） - 不能通过符号链接打开项目；VSCode 会跳过读取
.git，改用真实路径重开
另外，刚初始化仓库且只有 1 条提交时，视图看起来像文字列表——这是正常表现，不是故障。
点开提交后看不到代码 diff？别只盯着文件名列表
默认点击某次提交，只显示 author/time/message 和 “Files” 列表。真正要看改了哪几行，得手动操作：
- 确保右侧面板顶部有 Diff 标签（不是 Overview 或 Files）
- 如果 Diff 是灰色不可点，说明该文件是二进制（如图片）、被
.gitattributes忽略，或当前工作区根目录 ≠ 仓库根目录 - 遇到空 diff，右键该提交 →
Compare with Current Branch，比双击更稳；大文件（>50MB）或含 Unicode 路径时成功率更高
想看清分支合并关系？必须手动启用 Show Merge Commits
默认视图会隐藏 merge commit，导致分支线断裂、看不出 feature 是何时合入 main 的：
- 在历史视图右上角点齿轮图标 ⚙️，勾选
Show Merge Commits - 可选：同时启用
Show Tags和Limit to Current Branch缩小范围 - 启用后会出现带斜线连接的菱形节点，不同颜色代表不同分支——这是判断集成节奏的关键视觉线索
注意：git log --oneline --graph --all 在终端里永远是最稳的兜底方案，尤其当图形视图卡顿或 reflog 过大时。
为什么 Git: View File History 查不到某次修改？
这个命令只追踪「已被 Git 记录」的变更，和 git blame 粒度完全不同：
-
git blame显示每行最后一次谁改的；View File History只列出整份文件被完整提交过的 commit - 刚新建未
git add的文件、刚git stash但没 commit 的改动，都不会出现在历史里 - 若终端运行
git log --oneline -- path/to/file也为空，说明 Git 确实没这条路径的记录
真正容易被忽略的是：VSCode 的所有 Git 历史功能都依赖本地 git 命令输出结构化数据，Git 版本太老、core.autocrlf 配置异常、或 .git/logs/refs/heads/ 过大会直接导致图形视图加载失败或卡死——这时候切回终端才是最快解法。
