GitLens是VSCode中增强Git功能的插件，需配置codeLens、hovers和Git Explorer三项启用；Blame注解需手动刷新并可调至行首；Commits Explorer图形化展示提交变更；Recent Changes侧边栏支持快捷过滤与局部回滚。
GitLens 不是 Git 的替代品，而是 VSCode 里最实用的 Git 增强插件——它把提交历史、代码作者、变更追踪这些信息直接“贴”在编辑器侧边和行内，省去频繁切到终端或网页看 blame/history 的动作。
安装后必须做的三件事
刚装完 GitLens 默认只开基础功能，不手动配置就等于白装：
-
gitlens.codeLens.enabled设为true：让函数/类上方显示「最近谁改了这里」「多少次提交影响此行」这类CodeLens提示 -
gitlens.hovers.enabled设为true：鼠标悬停在代码行号左侧的 Git 图标上时，才能看到完整 commit message 和 author - 检查
gitlens.gitExplorer.enabled是否开启：这是左侧活动栏里的「Git Graph」视图入口，比 VSCode 自带的源代码管理面板更直观
用好「Blame Annotations」要调对位置和刷新策略
默认 Blame 显示在编辑器右边缘（gutter），但容易被折叠按钮挡住；而且它不会自动随 git pull 更新——很多人以为没生效，其实是没手动刷新。
- 右键编辑器空白处 →
GitLens: Toggle Blame Annotations可切换开启/关闭 - 想让它固定显示在行首（更易读）：在设置里搜
gitlens.blame.affordancePosition，改成left - 每次
git pull或git checkout后，按Ctrl+Shift+P→ 输入GitLens: Refresh Blame Annotations手动更新，否则仍显示旧 commit
快速定位某次提交影响了哪些文件？用「Commits Explorer」
VSCode 自带的「源代码管理」只列暂存/未暂存文件，查某次 commit 改了什么得去终端敲 git show 。GitLens 的 Commits Explorer 把这个操作图形化了。
- 点击左侧活动栏 GitLens 图标 → 选顶部
Commits标签 → 点击任意 commit → 右侧自动展开「Changed Files」列表 - 点某个文件名，会直接打开 diff 视图，高亮显示增删行；支持用
Ctrl+Click多选多个文件批量对比 - 注意：如果仓库很大（比如 >50k 提交），首次加载
Commits Explorer会卡顿几秒——不是坏了，是它在后台构建索引，等进度条消失即可
别忽略「Recent Changes」侧边栏的快捷过滤
这个面板默认藏在编辑器右侧（需右键文件标签 → GitLens: Show Recent Changes），但它能实时告诉你「这个文件最近被谁、什么时候、为什么改过」，比翻 log 高效得多。
- 顶部有三个过滤按钮：
All/Staged/Unstaged，对应不同工作区状态，别只盯着All - 每条记录旁的
⋯菜单里，Compare With Previous Version是最快做局部回滚的方式 - 如果某次修改没出现在这里，先确认该文件是否被
.gitignore忽略，或者是否还没执行过git add—— GitLens 只跟踪 Git 已知的文件
GitLens 的能力边界很清晰：它不帮你解决 merge conflict，也不替代 git rebase -i 这类重写历史的操作。真正容易被忽略的是它的「上下文感知」——比如你在某个分支上，所有 blame 和 commit 列表默认只基于当前 HEAD，切分支后不会自动刷新视图，得手动触发一次 refresh。这点不留意，看到的就可能是过期信息。
