gitLens 是 vscode 中强大的 Git 增强插件，通过行级 blame、交互式提交图谱、符号变更路径追踪、历史文件对比等功能，将代码演化过程可视化，提升协作效率与问题排查速度。
GitLens 是 VSCode 中最强大的 Git 增强插件之一，它把代码历史从“查提交”变成“读懂演化过程”。关键不在于看到更多日志，而在于快速定位谁改了哪行、为什么 改、上下文是否安全——尤其在接手老项目或排查偶发 bug 时，这能省下大量翻 commit 和比对分支的时间。
实时查看行级作者与提交信息
把光标停在任意一行代码上，左侧编辑器边缘会立刻显示该行最后修改的作者、提交哈希、简短消息和相对时间（如“2 days ago”）。点击这个内联信息，就能直接跳转到对应 commit 页面，附带完整 diff 和文件变更列表。
- 按 Alt+Click（windows/linux）或 Option+Click（macOS）可快速在当前行打开 blame 视图，以表格形式列出所有历史修改记录
- 右键某行 →“GitLens: Show Line history”可查看该行被修改过的全部 commit，过滤掉未动过此行的提交
- 开启设置 “gitlens.blame.ignoreWhitespace”: true，避免因格式调整产生的干扰性 blame 记录
可视化分支与提交关系图
通过命令面板（Ctrl+Shift+P）运行“GitLens: Open Commit Graph”，即可打开交互式图谱视图。节点代表 commit，连线表示父子 / 合并关系，不同颜色区分分支，悬停显示作者、时间、消息摘要。
- 双击任一 commit 跳转详情页，右侧自动同步显示该次提交影响的所有文件及变更类型（新增 / 修改 / 删除）
- 右键分支名 →“Compare with Current Branch”快速对比差异，支持选择任意两个分支做 diff
- 勾选右上角“Show Remote Branches”可同步查看 origin/main、upstream/develop 等远程分支位置
追溯函数或变量的完整变更路径
选中一个函数名、类名或变量名，右键选择“GitLens: Show Code Authorship”—— 插件会分析该符号在历史中的定义 / 重命名 / 移动轨迹，并高亮每次关键变更点。
- 特别适合 重构 后追查“这个方法怎么突然返回 undefined？”：它能指出是哪次 commit 把参数默认值删了，或在哪次重命名中漏改了调用处
- 结果视图中点击某个 commit，自动展开该次修改前后该符号所在文件的 diff 片段，无需手动定位行号
- 配合 “gitlens.codeLens.enabled”: true，函数上方还会常驻显示最近一次修改者和时间，一目了然
高效回溯与安全对比旧版本
不必 checkout 到旧 commit 就能读历史代码。在任意文件标签页右键 →“GitLens: Open File at Revision”，选择目标 commit 或日期，VSCode 会以只读方式打开该时刻的完整文件。
- 支持跨 commit 对比：先打开旧版文件，再右键当前编辑器 →“Compare With → Current File”，立刻获得双向 diff 面板
- 使用“GitLens: Compare Working Tree With……”可一键对比工作区与任意远程分支（如 origin/release/v2.1），提前发现本地遗漏的 hotfix
- 开启 “gitlens.advanced.messages.enabled”: false 可关闭部分提示弹窗，保持操作流不中断
基本上就这些。GitLens 的价值不在功能多，而在把 Git 的底层信息转化成编辑器里“伸手可得”的上下文。不需要记住命令，也不用切出 ide，改一行代码前顺手瞄一眼 blame，往往就能避开一个隐藏坑。
