gitlens需手动启用gitlens.blame.lineenabled等设置才能在每行代码旁显示作者和时间，且依赖文件已提交、仓库有效；状态栏toggle line blame图标须为蓝色，未跟踪或新文件不显示注解。
VSCode 内置 Git 功能本身不复杂，真正卡住人的不是“不会用”，而是“不知道哪些信息能直接从代码行里拿”。GitLens 的价值不在功能多，而在它把 git blame、git log -L、git diff 这些命令的输出，实时、精准、无感地贴在你正在看的那行代码旁边。
怎么让每行代码自动显示谁改的、什么时候改的
这是 GitLens 最基础也最不能关的功能。默认安装后可能没开，或者只开了部分注解。
- 打开设置（
Cmd + ,或Ctrl + ,），搜索gitlens.gbl.annotations.enabled，确保勾选 - 再搜
gitlens.blame.format，建议设为${author initials} ${dateShort} — ${message}，比默认更紧凑易读 - 状态栏左下角 Git 分支名旁有个小图标，叫
Toggle Line Blame，必须是蓝色高亮态才生效；灰色=关闭 - 如果某行没显示注解，先确认文件在 Git 仓库内、且已提交过至少一次——未跟踪或全新文件不会出 blame 信息
右键菜单里哪些 GitLens 选项真正省时间
别点“Show File History”这种入口深的，高频操作都藏在编辑器右键里，光标停在哪就作用于哪。
-
GitLens: Compare Line with Previous Revision：调试时发现某行逻辑异常，一按就看到上一次修改它的完整 diff，包括改前值、作者、PR 链接 -
GitLens: Open File on Remote：跳转到 GitHub/GitLab 当前 commit 对应的文件页，前提是已在 VSCode 设置里配好gitlens.remoteProviders -
GitLens: Annotate with Previous Commit：当某段代码被多人反复改过，这个命令会高亮显示“上一次动这行的人”，不是最近一次，而是上一轮变更 - 慎用
GitLens: Show Commit Details——它弹窗展示的是当前光标所在行的提交，但如果你没把光标放在有 blame 注解的行上，结果可能是空或错的
Commit Graph 不是摆设，但得知道怎么筛数据
打开 GitLens: Show Commit Graph 后，满屏节点容易懵。关键不是看全图，而是快速定位。
- 顶部搜索框支持正则：
fix|bug找修复类提交，feat.*login找登录相关新功能 - 按住
Ctrl（Windows/Linux）或Cmd（macOS）多选两个 commit，右键 →Compare Selected Commits，直接出区间 diff，比git diff a..b少输一半命令 - 分支标签可拖拽：把
main往左拉，把feature/order往右拉，分叉点和 merge 点立刻变清晰；但注意，拖拽不改变 Git 状态，只是视图重排 - 点击任一 commit 后，右侧面板默认只显示变更文件列表；想看具体改了哪几行，得手动点进某个文件，再点
Show Diff按钮——这步常被忽略
为什么有些 blame 注解颜色不对或根本不出
不是插件坏了，大概率是 GitLens 没拿到足够上下文，或你的本地仓库状态干扰了注解生成。
- 刚
git checkout切换分支后，blame 注解可能延迟 1–2 秒才刷新；等不及就手动右键 →GitLens: Refresh Annotations - 如果某文件被
.gitignore忽略，或处于untracked状态，注解不会出现；检查 VSCode 底部状态栏 Git 图标是否显示分支名，不显示=没识别为仓库 - 多人共用一个远程仓库但没配置 remote provider（比如 GitHub/GitLab 地址），
Open on Remote类功能失效，但 blame 本身不受影响 - Mac 上用 M3 芯片+Sequoia 系统时，偶尔遇到
gitlens.highlighters.authors颜色映射不生效，临时解决是重启 VSCode 并清空~/.vscode/extensions/gitkraken.gitlens-*/out/缓存目录
最常被跳过的其实是“注解刷新时机”——它默认设为 onFocusChange，意味着你切到别的 tab 再切回来才会更新。改成 onSave 才能保证每次保存后立即反映最新 blame，否则你会以为功能失灵。
