GitLens 默认不显示行级作者信息，需手动开启 gitlens.blame.lineEnabled、gitlens.codeLens.enabled 和 gitlens.historyExplorer.enabled 三项设置；行级历史功能依赖本地 Git 仓库正确加载，常见失效原因包括工作区非仓库根目录、源代码管理未激活、文件未跟踪或 git.path 配置错误。
GitLens 默认不显示行级作者信息，必须手动开启对应设置，否则右键菜单里看不到“Show Line History”，悬停也无反应。
确认 Git 仓库已正确加载
Blame 信息完全依赖本地 .git 目录和提交历史。常见失效场景包括：
- VSCode 工作区打开的是子目录而非 Git 仓库根目录（
.git不在当前工作区路径下） - 状态栏左下角显示 “No source control providers active” 或无分支名（如
main） - 文件处于
Untracked files状态（git status可验证） - 使用 WSL 或远程开发时，
git.path设置错误（例如未指向/usr/bin/git）
启用关键设置：行内 Blame 和代码镜头
安装 GitLens 后默认功能极弱，以下三项必须设为 true：
-
gitlens.blame.lineEnabled：控制是否在代码右侧显示作者/时间戳（即“行内 blame”） -
gitlens.codeLens.enabled：控制函数/方法上方是否显示Authored by …这类代码镜头 -
gitlens.historyExplorer.enabled：决定侧边栏能否打开 History Explorer 视图
在 VSCode 设置中搜索对应项勾选即可；不要依赖插件默认值。
调用行级历史的正确方式
光标停在某行后，有三种常用入口，用途不同：
- 悬停在行号左侧 gutter 区域 → 显示简略作者 + commit 前缀（需
gitlens.blame.lineEnabled开启） - 右键 →
GitLens: Show Line History（快捷键Alt+H L）→ 查看该行所有修改记录，含完整 diff 对比 - 右键 →
GitLens: Blame Annotated Line→ 仅高亮当前行并显示作者头像，适合快速确认
注意：Show Line History 本质调用 git blame -L，对刚新增未提交的行、空行、纯注释行不返回结果；若某次提交中该行被整块删除又重建，历史链会中断。
容易被忽略的兼容性细节
GitLens 不解析 .git 目录，而是直接调用 git 命令。这意味着：
- 本地 Git 配置异常（如
core.pager自定义、diff.algorithm改动）可能导致某些视图空白 - 遇到诡异情况，先在终端运行等效命令验证：
git blame -L <line>,<line> -- <file></file></line></line> - 大文件（>1MB）或超长历史（>1000 提交）首次加载可能卡顿数秒，可临时设
gitlens.advanced.blame.ignoreWhitespace为true加速 - 作者名来自提交记录的
author.name字段，不是 GitHub 账号；邮箱变更未整理会导致同一人显示多个邮箱（如john@old.com/john@new.com）
