gitlens 的 author blame 默认不显示作者名，因需手动启用且依赖文件被 git 跟踪；常驻左侧 gutter 需开启 gitlens.blame.line.enabled；“unknown author”或“no committed yet”反映真实 git 状态；blame 不自动刷新，需手动触发 refresh file blame。
GitLens 的 Author Blame 功能为什么没显示作者名
默认安装 GitLens 后，Author Blame 不会自动在编辑器左侧显示作者信息，必须手动启用或触发。常见现象是右键菜单里没有 GitLens: Toggle Line Blame，或者按快捷键没反应——本质是当前文件未被 Git 跟踪，或工作区未正确识别为 Git 仓库。
实操建议：
- 确认项目根目录存在
.git文件夹，且 VSCode 打开的是该目录（不是子文件夹） - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入并执行GitLens: Toggle Line Blame - 若仍不显示，检查状态栏右侧是否有 Git 分支标识；没有则说明 GitLens 未检测到仓库，可点击状态栏 Git 图标 →
Open Repository...
如何让作者信息常驻左侧 gutter（而不是悬浮）
GitLens 默认以悬浮 tooltip 方式展示 blame 信息，要固定显示在行号旁，需修改设置。这个选项容易被忽略，因为 UI 上没有开关按钮。
实操建议：
- 打开设置（
Ctrl+,），搜索gitlens.blame.line.enabled - 勾选该配置项，或直接在
settings.json中添加："gitlens.blame.line.enabled": true
- 注意：开启后每行左侧 gutter 会显示作者名 + 提交简写哈希（如
alice@abc123），但不会显示完整提交信息——那是gitlens.blame.heatmap.enabled控制的热力图功能
为什么某一行显示 “Unknown author” 或 “Not committed yet”
这不代表插件出错，而是 Git 元数据层面的真实状态。GitLens 的 blame 信息完全依赖 git blame 命令输出，它只追溯已提交的变更。
常见原因与应对：
-
Not committed yet：该行属于当前工作区新增/修改内容，尚未git add或git commit -
Unknown author：该提交的user.name或user.email为空，或使用了本地未配置的邮箱别名（比如用公司邮箱 commit，但本地 Git config 没设对应映射） - 临时补救：运行
git config --local user.name "Your Name"和git config --local user.email "you@example.com"，再重新 commit
blame 信息不实时更新？修改后需要手动刷新吗
GitLens 默认自动监听文件保存和 Git 状态变化，但有三个关键例外场景会导致 stale blame 显示：
- 执行了
git rebase或git filter-branch后，本地 commit hash 变更，但 GitLens 缓存未清 - 多人协作中，你
git pull了新提交，但未触发重新 blame（尤其当文件未改动时） - 启用了
gitlens.advanced.caching.enabled且缓存过期策略较宽松
此时最直接的办法是右键编辑器 → GitLens: Refresh File Blame，或快捷键 Ctrl+Alt+B（Windows/Linux）/Cmd+Option+B（macOS）。别依赖“等几秒自动更新”，它真不会。
