VSCode 内无法直接生成按作者统计的贡献热力图；GitLens 热力图仅基于 git blame 显示每行最后一次修改时间（红=近期，蓝=久远），不区分作者、不累计修改次数、不反映新增/删除行数，仅辅助定位高频变更区域。
VSCode 内无法直接通过内置功能生成“贡献热力图”——GitLens 提供的所谓热力图，本质是代码行修改时间的视觉映射，不是按作者、按新增/删除行数统计的“贡献量”。想看谁写了多少行，它不干这事。
GitLens 热力图显示的是“哪行最近被改过”，不是“谁写了多少行”
热力图颜色（红→蓝）只反映该行最后一次 git blame 的相对时间：红色 = 近期修改，蓝色 = 久未动过。它不区分作者，也不累计修改次数。同一行被 A 改一次、B 改一次，热力图只标记 B 的那次时间点，A 的痕迹完全消失。
- 热力图数据来源是
git blame，而非git log --numstat或 PR 数据 - rebase 后的历史会覆盖原始作者信息，热力图上所有行都会显示 rebase 操作者
- merge commit 默认被忽略，但若 merge 带了文件变更（如自动解决冲突），那几行会被标为 merge 提交者
开启热力图的三种方式，效果略有差异
三种入口最终都调用同一套渲染逻辑，但触发位置不同，影响显示范围：
-
命令面板：
Ctrl+Shift+P→ 输入GitLens: Toggle File Annotations→ 选Heatmap：仅对当前打开文件生效 -
编辑器右上角 GitLens 图标 →
Annotations→Heatmap：同上，但更易误点成全局开关（实际仍是文件级） -
设置项：
gitlens.annotations.type设为"heatmap"：设完后所有受控文件默认启用，但滚动条热力图需额外开启gitlens.gutterHeatmap.enabled
注意：gitlens.gutterHeatmap.enabled 控制是否在滚动条区域显示色带；gitlens.gutterEnabled 控制行号旁的 blame 图标——两者独立，别混淆。
热力图容易失效的几个真实场景
不是插件坏了，而是 Git 元数据缺失或 VSCode 识别错位：
- 文件刚被
git add但尚未git commit：blame 无历史，热力图全蓝或不渲染 - 工作区根目录 ≠ Git 仓库根目录（比如你在子包里开 VSCode，而
.git在父级）：GitLens 找不到仓库，热力图空白 - 文件被
.gitattributes标记为diff=none或binary：blame 失败，热力图不显示 - 启用了
core.autocrlf=true且跨平台协作：换行符差异导致 blame 时间戳错乱，热力图颜色跳变
热力图真正有用的地方，是快速定位“哪些区域最近被反复动过”，而不是回答“张三到底写了多少行”。如果你需要后者，得切到终端跑 git log --author="zhangsan" --numstat --since="6 months ago" -- src/，别指望编辑器里的颜色块替你算清楚。
