gitlens行级作者和历史信息不会自动出现，必须同时满足三个硬性条件：工作区已识别为git仓库、当前文件已被git add或提交过、且gitlens.blame.lineenabled等关键设置为true；否则gutter无头像、右键无菜单、show line history返回空列表——不是插件故障，而是环境未就绪。
GitLens 行级作者和历史信息不会自动出现，必须同时满足三个硬性条件：工作区已识别为 Git 仓库、当前文件已被 git add 或提交过、且 gitlens.blame.lineEnabled 等关键设置为 true；否则 gutter 无头像、右键无菜单、GitLens: Show Line History 返回空列表——不是插件坏了，是环境没对上。
为什么光标停在某行，左侧 gutter 没作者和 commit 信息
这是最常卡住的第一步。GitLens 默认不自动渲染 blame 注释，必须手动开启且文件状态合规：
-
gitlens.blame.lineEnabled必须为true（默认开启，但有人为省性能关掉） - 当前文件不能是
Untracked files：终端执行git status，该文件需出现在modified或Changes to be committed列表中 - VSCode 左下角状态栏必须显示分支名（如
main），若显示No source control providers active，说明工作区未识别到.git - 某些后缀（如
.log、.tmp）被 GitLens 主动忽略，即使已git add也不会注入 blame - 快捷键
Ctrl+Alt+H（Windows/Linux）或Cmd+Option+H可强制开关，比依赖右键更可靠
右键没有 “GitLens: Show Line History” 怎么办
这个菜单项默认不注入任何上下文，不是 bug，是设计如此。别等它出现，直接走命令面板：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入并执行
GitLens: Show Line History - 结果为空？说明该行从未被单独修改过——可能是整块复制粘贴、函数重写、或从其他文件搬来，Git 无法建立行级连续性
- 只显示 1 条记录？大概率是这行自首次提交后就没被改过，或者后续变更全是空格/换行（被
gitlens.history.excludeTrivialCommits折叠） - 想穿透 merge commit？需手动启用
gitlens.advanced.git.enableMergeCommits
“Compare with Previous Revision” 没反应的真正原因
这个按钮看着方便，但限制极多，容易误判：
- 它只对比当前工作区与
HEAD~1，要求文件至少有两次提交；首次提交后无效果 - 当前文件若有未暂存修改（
git status显示modified），会直接报no previous revision - 选中几行再右键调用，它只 diff 这几行——但前提是这些行在
HEAD~1中真实存在；若上一版删了又重建，结果为空白 - 真要对比任意两个 commit（比如
abc123和def456），必须先打开GitLens: Open File Timeline
最容易被忽略的是：GitLens 不解析 .git 目录，而是直接调用 git 命令。本地 git 配置异常（如 core.pager 自定义、diff.algorithm 改动）可能导致某些视图空白；遇到诡异情况，先在终端运行等效命令验证：git blame -L <line>,<line> -- <file></file></line></line>。
