GitLens 插件可在 VSCode 内直接查看代码行的提交作者、时间及原因；需先安装启用，再通过悬停/点击触发 Inline Blame，或用命令面板调用 Show Line History 查看完整历史，还可开启热力图与自定义 blame 格式。
如果您在使用 VSCode 编辑器时希望快速查看某一行代码是谁在何时修改、为何修改，GitLens 插件能直接在编辑器内呈现详细的 Git 历史信息。以下是启用并高效使用 GitLens 查看代码行历史的操作说明：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 GitLens 插件
GitLens 是一个开源的 VSCode 扩展，它深度集成 Git 功能，无需切换终端即可获取 blame 信息、提交详情与分支对比。安装后需确保其处于启用状态，否则右键菜单和内联注释不会出现。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 GitLens，找到作者为 GitKraken 的官方插件。
3、点击“安装”，安装完成后点击“重新加载”按钮使插件生效。
二、查看单行代码的提交历史（Blame）
GitLens 默认在编辑器右侧边缘显示每行代码的最近一次提交作者、简短提交信息与时间戳，该功能称为 Inline Blame。用户可直接悬停或点击触发更详细视图。
1、打开一个已纳入 Git 版本控制的文件。
2、将鼠标悬停在任意代码行的左侧空白区域（行号右侧），出现浅灰色作者名与提交哈希前缀即表示 Inline Blame 已激活。
3、点击该行旁的作者信息，弹出面板中将显示完整提交消息、提交者邮箱、变更文件列表及关联的 Pull Request 链接（如存在）。
三、使用命令面板调用高级 Git 历史分析
GitLens 提供了超过 50 个命令，涵盖从单行追溯到跨分支比较的多种场景。通过命令面板可绕过 UI 限制，精准定位历史上下文。
1、按下 Cmd+Shift+P 打开命令面板。
2、输入 GitLens: Show Line History 并回车，当前光标所在行的所有历史提交将以时间倒序列表呈现。
3、在结果列表中选择某次提交，右侧将自动打开该提交的 diff 视图，高亮显示该行在此次提交中的增删变化。
四、启用文件级代码作者热力图
GitLens 可基于提交频率与时间生成可视化热力图，帮助识别文件中不同区域的维护责任人分布，适用于团队协作审查与交接评估。
1、在编辑器中打开目标文件后，右键点击编辑区空白处。
2、选择 GitLens: Toggle Code Authorship Heatmap。
3、编辑器背景将叠加半透明色块：红色代表近期频繁修改，蓝色代表较早且少有变动，颜色深浅反映提交密度。
五、配置自定义 Blame 提示格式
默认 Inline Blame 显示内容有限，用户可通过设置调整显示字段，例如加入提交标题、Jira ID 或评审人信息，以适配内部开发流程。
1、打开 VSCode 设置（Cmd+,），搜索 gitlens.blame.format。
2、点击“在 settings.json 中编辑”，添加如下配置项：
3、将值设为 "${author} • ${message|100} • ${ago}"，其中 100 表示截取提交消息前 100 字符。
