GitLens 能解决VSCode中提交上下文缺失、代码修改者不明、溯源困难三类问题，但需启用内联blame、文件历史视图，并理解其仅追踪已提交/暂存变更；未暂存修改需先git add才能被分析。
GitLens 能直接解决你在 VSCode 里“看不见提交上下文”“搞不清谁改了哪行”“想回溯却找不到源头”这三类问题，但装上不等于能用好——关键在启用对应视图和理解它默认不追踪未暂存变更。
为什么 git blame 信息不显示在行首？
GitLens 默认关闭内联 blame（inline blame），即使插件已启用，你也看不到每行末尾的作者/提交哈希。
- 打开设置（
Ctrl+,或Cmd+,），搜索gitlens.blame.enabled，确保勾选 - 再搜
gitlens.views.fileHistory.visibility，设为visible才能在侧边栏看到文件历史 - 如果只对当前文件生效，右键编辑器 →
GitLens: Toggle Blame Annotations可临时开关 - 注意：未保存或未暂存的修改不会出现在 blame 中——GitLens 显示的是 Git 已知的版本，不是编辑器缓存
如何快速定位某行代码是谁、什么时候、为什么改的？
把光标停在任意一行，按 Alt+Click（Windows/Linux）或 Option+Click（macOS）即可弹出 commit 详情浮层；也可用快捷键 Ctrl+Alt+H（Win/Linux）或 Cmd+Option+H（macOS）唤出「Code Authorship」视图。
- 浮层里点
Open File at Revision可对比该次提交前后的差异 - 点
Compare with Previous Revision直接进入双列 diff，不用手动找 parent commit - 若浮层空白，检查该行是否属于未提交的新增内容（比如全新函数），此时 GitLens 没有历史可追溯
- 该功能依赖本地 Git 仓库完整历史，
git clone --depth=1的浅克隆会导致早期 blame 失效
怎么让 GitLens 显示未暂存更改的来源？
GitLens 默认只分析已提交/已暂存的内容，未 git add 的修改不会被纳入 blame 或历史比对。
- 启用
gitlens.advanced.cachedRepositorySearch并设为true，可提升未暂存变更的索引响应速度（但不改变其不可追溯的本质） - 真正要追溯未暂存修改，得先
git add -p分块暂存，再用GitLens: Show History for Selected Range（右键选择代码后触发） - 别指望 GitLens 替代 IDE 的本地历史（Local History），它不记录你 Ctrl+Z 过的每一版——那是编辑器自己的事
GitLens 的强项是把 Git 命令变成点击操作，但它不会绕过 Git 本身的约束。最常被忽略的一点：它所有时间线、作者归属、变更溯源都基于 .git 当前状态，而不是你编辑器里开着的未保存文件。改完记得 git add，否则你看到的永远是“最近一次提交”的视角。
