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与提交图谱中作者标识将同步更新样式。










