gitlens 是目前 vscode 中唯一能稳定实现「行级 js 代码变动追踪」的插件，它直接读取 git blame 数据映射到每行 js 代码，需文件已纳入 git 仓库且有提交历史；默认不启用，须手动开启 gitlens.gutterenabled 和 gitlens.codelens.enabled 才能在 gutter 和行尾显示作者、时间等信息。
GitLens 是目前 VSCode 中唯一能稳定实现「行级 JS 代码变动追踪」的插件，它不依赖你记得改了哪几行，而是直接读取 Git 的 git blame 数据，把真实提交记录映射到每一行 JS 代码上。
为什么默认 CodeLens 在 JS 文件里显示不准
VSCode 原生 CodeLens 对 JavaScript 支持有限：它只在函数声明、类定义等顶层符号处显示“引用数”或“测试覆盖率”，但不会显示“谁、什么时候、为什么改了这行”。GitLens 补足的就是这个缺口——它把 git blame 结果注入到 JS 文件的 gutter（行号区）和行尾，前提是文件已纳入 Git 仓库且有提交历史。
- 如果某行 JS 是刚新建的、还没
git add，GitLens 不会显示作者信息 - 若该行近期被格式化工具（如 Prettier）重排过，
git blame可能指向格式化提交而非逻辑修改者，需配合git blame -w（忽略空格变更）手动查 - TypeScript 项目中，JS 输出文件（如
dist/*.js）默认被 Git 忽略，GitLens 不生效——必须追踪源码.ts文件
启用 JS 行级作者标注的最小配置
只需两步，无需改 src/config.ts 这类开发级配置：
- 确保
"gitlens.gutterEnabled": true（控制侧边栏 blame 图标） - 确保
"gitlens.codeLens.enabled": true（控制行尾 CodeLens 文字，如 “by @alice 3 days ago”） - 可选但推荐：
"gitlens.hover.showAvatar": false，避免悬停时加载头像拖慢响应
这些都写在 VSCode 的 settings.json 里，不是 GitLens 插件内部配置。改完不用重启，保存即生效。
点击 blame 标记后怎么快速确认 JS 修改上下文
行号左侧的绿色/红色小图标（或行尾文字）点一下，弹出的面板才是关键：
- 面板顶部显示该行对应的完整提交哈希、消息、作者和时间，**注意看提交消息是否含关键词如 “fix”、“refactor”、“perf”**
- 右上角有 “Compare with Previous Version” 按钮——点它，VSCode 会打开 diff 视图，**直接对比这行代码在本次提交前后的差异，而不是整个文件**
- 如果这行 JS 是从另一个分支 cherry-pick 过来的，面板里会显示原始提交链接，点进去能看到更早的上下文
- 慎用 “Open File at Revision”：它打开的是该提交时刻的整个文件快照，对 JS 来说可能缺失当前依赖的模块类型定义，容易报错
当 GitLens 显示空白或延迟时先查这三件事
JS 文件里 blame 信息没出来，90% 是以下原因：
-
git status是否显示该 JS 文件为 “untracked”？未纳入版本控制的文件，GitLens 拿不到任何 blame 数据 - VSCode 底部状态栏是否显示 “Git: X changes”？如果显示 “No source control providers”，说明工作区没识别到 Git 仓库（比如开了子目录而非根目录）
- 该 JS 文件是否在
.gitignore里？常见陷阱是dist/、node_modules/或构建产物被忽略，GitLens 完全无视它们
真正容易被忽略的，是 JS 代码被 Webpack/Vite 等工具动态生成并写入内存文件系统（如 webpack:// 协议路径），此时 GitLens 无法关联真实磁盘路径——这种场景必须回退到源码 .ts 或 .js 文件上操作。
