GitLens 查看代码修改者需分清三种粒度：单行 blame、单行完整历史链、整文件提交时间线；右键无“Show Line History”因文件未提交、未识别 Git 仓库、设置关闭或文件被忽略；命令面板调用最可靠，支持穿透 merge commit 与任意版本对比。
GitLens 查看代码修改者的详细提交历史，核心不是“点开就看到”，而是分清三种粒度：单行 blame、单行完整历史链、整文件提交时间线——每种触发方式、依赖条件和常见失效原因都不同。
为什么右键没出现 GitLens: Show Line History？
这不是插件装错了，而是当前光标所在行不满足 GitLens 的追溯前提：
- 该行必须属于一个
git add过且至少被git commit一次的文件；git status里不能是Untracked files - VSCode 左下角状态栏必须显示分支名（如
main），若显示No source control providers active，说明工作区没识别到.git -
gitlens.blame.lineEnabled设置必须为true（默认开启，但有人为省性能手动关了） - 某些文件类型（如
.log、.tmp）会被 GitLens 主动忽略，即使在 Git 仓库中也不会注入右键菜单
用命令面板调用 Show Line History 最稳
别卡在右键菜单是否出现上。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行：
GitLens: Show Line History
它会立即列出光标所在行的所有历史提交（按时间倒序），点击任一 commit，右侧自动打开 diff 视图，高亮该次提交中这行的具体增删变化。注意：
- 如果只显示 1 条记录，大概率是这行从未被单独修改过，而是随函数/块整体移动或重写而来
- 遇到
merge commit时，GitLens 默认跳过父提交；若想穿透合并，需在设置中启用gitlens.advanced.git.enableMergeCommits - 首次加载可能卡顿几秒——大文件或超长历史（>500 次）下，可临时设
gitlens.history.excludeTrivialCommits为false避免折叠空格/换行变更
对比两个版本时，“Compare with Previous Revision” 不等于“Compare with Any Revision”
编辑器右上角那个按钮只比对当前工作区与 HEAD~1，它快但局限大：
- 要求文件已提交过至少两次，且当前无未暂存修改；否则提示
no previous revision - 选中某几行再右键调用，它只会 diff 这几行，但前提是这些行在
HEAD~1中真实存在——如果上一版里这行被删了又重建，结果为空 - 真要对比任意两个 commit（比如
abc123和def456），得先打开GitLens: Open File Timeline，按住Ctrl（或Cmd）多选，再右键Compare Selected Revisions
作者名显示邮箱前缀？那是 Git 配置决定的，不是 GitLens 能改的
GitLens 显示的作者名直接读取 git log 输出里的 author.name 字段。如果你看到 john@company.com 而非 John Doe，说明本地 Git 配置没设好：
git config --global user.name "John Doe"
但注意：这个改动只影响后续新提交，旧提交无法回填。更麻烦的是，有些企业 Git 平台（如 Azure DevOps）会强制覆盖 user.name 为登录用户名，这时得去平台个人资料页补全“Display Name”。另外，如果同一个人用过多个邮箱（john@old.com / john@new.com），GitLens 会如实显示——这不是 bug，是 Git 历史本来就这么碎。
