GitLens 可实现代码变更可视化、作者与时间精准定位及历史追溯：启用内联 blame 显示每行作者与提交信息；调出提交图谱查看分支演进；用 Blame Line 定位某行原始提交；通过文件历史侧边栏快速比对版本；自定义作者颜色与头像提升协作识别效率。
如果您希望在 VSCode 中直观查看代码的每一次变更、精准定位某行代码的作者与修改时间，并快速追溯历史版本，则 GitLens 正是为此类需求深度优化的增强型 Git工具。以下是围绕 GitLens 核心功能展开的操作指引：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用内联代码作者与提交信息
该功能在编辑器右侧边缘实时显示每行代码最近一次提交的作者、简短提交信息及时间戳，无需切换面板即可掌握上下文。
1、确保已安装并启用 GitLens 插件。
2、打开一个受 Git 管理的项目文件。
3、在 VSCode 设置中搜索gitlens.codeLens.enabled，将其设为true。
4、在设置中查找gitlens.codeLens.recentChange.enabled，确认开启。
5、保存设置后，代码行右侧将立即出现灰色小字标注，悬停可查看完整提交详情。
二、调出交互式提交图谱视图
提交图谱以时间线 + 分支拓扑形式可视化整个仓库的演进路径，支持点击跳转、对比差异与回退操作，是理解复杂协作历史的关键入口。
1、按下Cmd+Shift+P（macOS）调出命令面板。
2、输入 GitLens: Open Commit Graph 并回车。
3、视图加载后，左侧为分支列表，中央为主时间轴，节点大小反映提交量。
4、点击任意提交节点，右侧自动展开该次提交的文件变更摘要。
5、右键某节点可选择 Compare with Previous 或Revert Commit等快捷操作。
三、快速定位某行代码的原始提交
通过“blame on line”机制，可精确查出当前光标所在行最初由谁在哪个提交中引入，适用于排查问题源头或确认责任归属。
1、将光标置于目标代码行任意位置。
2、右键选择GitLens: Blame Line，或使用快捷键Cmd+Alt+H。
3、编辑器顶部将临时显示一行高亮信息条，含作者名、提交哈希、相对时间及消息前缀。
4、点击信息条中的提交哈希，将跳转至该次提交的详细页面。
5、在提交详情页中可点击任意变更文件，直接比对当前工作区与该提交版本的差异。
四、启用文件级历史侧边栏
该侧边栏聚合展示当前打开文件的所有历史提交记录，按时间倒序 排列，支持一键打开任意版本进行只读比对。
1、在 VSCode 活动栏点击 GitLens 图标（绿色叶子形状）。
2、在侧边栏顶部选择 File History 标签。
3、确保当前编辑器中已打开一个 Git 追踪下的文件。
4、列表将自动填充该文件全部提交记录，每项含作者头像、提交摘要与相对时间。
5、双击任一记录，在新编辑器标签页中以只读方式打开该版本快照。
五、自定义作者标识颜色与头像映射
GitLens 支持为不同贡献者分配唯一颜色与头像，大幅提升多人协作场景下作者识别效率，避免姓名缩写混淆。
1、进入 VSCode 设置，搜索gitlens.authors.colorization。
2、将选项设为 byAuthor 或byEmail以启用颜色区分。
3、在设置中查找 gitlens.authors.avatarStyle，选择circle 或square。
4、如需绑定特定 邮箱 到头像，访问 ~/.gitconfig，在[user] 段落确认 email 字段准确无误。
5、重启 VSCode 使头像与颜色配置生效，内联 blame 与提交图谱中作者标识将同步更新样式。
