GitLens 可在 VSCode 中直观展示代码行的提交作者、时间、原因及关联记录；需安装插件、启用 Blame 标注、使用 Code Lens 查看历史、内联对比多版本差异，并可自定义快捷键提升效率。
如果您在使用 VSCode 编辑代码时，希望快速了解某一行代码由谁在何时提交、为何修改、关联了哪些提交记录，则 GitLens 插件可直接在编辑器内呈现这些历史信息。以下是启用并高效使用 GitLens 的关键操作步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并启用 GitLens 插件
GitLens 并非 VSCode 内置功能，需通过扩展市场手动安装，安装后默认启用部分核心能力，但需确认其状态为激活且未被其他 Git 扩展冲突屏蔽。
1、打开 VSCode，点击左侧活动栏最下方的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入 GitLens，找到作者为 GitKraken 的官方插件。
3、点击“安装”按钮，安装完成后点击“重新加载”使插件生效。
4、重新加载后，打开任意已纳入 Git 版本控制的文件，将鼠标悬停在代码行号左侧的空白区域，观察是否出现提交哈希与作者信息。
二、启用行内代码作者标注（Blame Annotations）
该功能在编辑器右侧边缘实时显示每行代码的最近一次变更提交者、时间及简短消息，是“看到前世今生”的最直观入口。
1、按下 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux），打开命令面板。
2、输入 GitLens: Toggle Blame Annotations 并回车，启用行内标注。
3、若未立即显示，尝试保存当前文件或切换到其他 Git 仓库内的文件以触发刷新。
4、将光标移至任意代码行，右侧边缘将浮现作者名、提交时间缩写及提交摘要前缀；点击该信息可跳转至对应提交详情页。
三、调出代码行时间线视图（Code Lens）
Code Lens 在代码上方插入可点击的操作链接，提供围绕当前行的历史追溯路径，包括“查看此行所有变更”“比较不同版本”等深度操作。
1、确保光标位于目标代码行的任意位置。
2、等待约 1–2 秒，代码行上方将自动出现灰色小字链接，如 Blame、History、Compare with Previous。
3、点击 History，右侧将弹出时间线面板，列出该行曾被修改的所有提交，按时间倒序排列。
4、在时间线中点击任一提交条目，编辑器将并排显示当前版本与该提交版本的差异，高亮出该行在此次提交中的具体变更内容。
四、使用内联差异对比定位变更细节
当某行代码被多次修改，仅看单次提交可能无法还原完整演进逻辑，内联差异模式可将多个历史版本叠加比对，逐字符揭示增删改痕迹。
1、右键点击目标代码行号左侧的 GitLens 提交标记（即 Blame 区域的小圆点或作者缩写）。
2、在上下文菜单中选择 Show History for Line。
3、在弹出的历史列表中，按住 Cmd 键（Mac）或多选两个以上提交条目。
4、右键选中项，选择 Compare Selected Commits Inline，编辑器将生成一个临时只读文档，以颜色区块清晰标示各版本间该行的字符级差异。
五、配置 GitLens 自定义快捷键快速呼出关键功能
默认快捷键未覆盖全部高频操作，手动绑定可大幅提升追溯效率，尤其适用于需频繁比对多版本的复杂逻辑审查场景。
1、按下 Cmd+, （Mac）打开设置界面，切换至“键盘快捷方式”标签页。
2、在搜索框中输入 gitlens.line.history，找到对应命令。
3、双击该命令右侧的“+”号，输入新快捷键组合，例如 Cmd+Alt+H。
4、同理，为 gitlens.compareWithPrevious 和 gitlens.showFileHistory 分别分配快捷键，确保三者不冲突且便于左手操作。
