GitLens 需 Git 仓库初始化且配置正确才能显示行级 blame 信息；常见问题包括 Git 未安装、路径错误、远程开发未启用集成、重命名文件未开启 renames 支持、大/二进制文件被忽略，以及索引未刷新导致信息滞后。
GitLens 能直接在 VSCode 编辑器里显示每行代码的最后一次提交人、时间、提交信息和 commit hash——但前提是 Git 仓库已正确初始化，且你没跳过权限或缓存配置这步。
GitLens 安装后没反应？检查 Git 是否可用且仓库已初始化
常见错误现象：Git: not found 报错、右键菜单无 GitLens 选项、行首不显示 blame 信息。
- VSCode 内置终端运行
git --version，确认输出版本号；若报错，需先安装 Git 并把git加入系统 PATH - 确保当前打开的是 Git 仓库根目录（即存在
.git/文件夹），不是子文件夹或未git init的项目 - 如果用 WSL 或远程开发（SSH/Containers），GitLens 默认不自动启用远程端 Git，需在远程设置中手动启用
gitlens.advanced.enableRemoteHubIntegration
为什么某行没显示 blame 信息？和 Git 历史完整性强相关
使用场景：刚 checkout 到某个分支、rebase 后、或文件被重命名过，blame 可能中断。
- GitLens 默认只追溯当前文件路径的历史；若该文件由其他文件
git mv重命名而来，需开启gitlens.codeLens.scopes中的renames支持（设为true） - 大文件或二进制文件（如
.png、.pdf）默认被跳过 blame，可通过gitlens.git.ignoreWhitespaces和gitlens.codeLens.ignoreBinaryFiles调整 - 首次打开大仓库时，GitLens 会后台预加载历史，等待几秒再看行号旁是否出现灰色小字；可查状态栏右下角
GitLens: indexing...
如何快速查看某行的完整提交详情？别只盯着左侧行号
参数差异：鼠标悬停显示简略信息，真正有用的是右键上下文操作。
- 在代码行左侧空白处右键 → 选
GitLens: Show Blame Annotations可强制刷新当前文件 blame - 光标放在某行任意位置，按快捷键
ctrl+shift+p（Windows/Linux）或cmd+shift+p（macOS），输入GitLens: Open File Blame Side-by-Side，会并排显示带完整 commit 列表的 blame 视图 - 想追溯某次提交改了哪些行？在
GitLens侧边栏点开Commits，找到 commit，右键选Compare With Previous，它比原生 Git diff 更聚焦变更行
最容易被忽略的是：GitLens 的 blame 结果依赖 Git 的本地索引速度，而不是实时调用 git blame。如果你刚 git pull 但没看到新提交人，不是插件坏了，是它还没自动刷新索引——手动触发一次 GitLens: Refresh 就行。
