gitlens不能查看运行代码历史，只追踪git提交的源码变更；需满足仓库识别、文件已跟踪、配置启用三条件，否则gutter空白、右键无菜单、行历史为空——非插件故障，是git未记录该代码。
GitLens 不能直接查看“运行代码”的历史——它只追踪 Git 提交记录里的源码变更，不感知运行时状态或构建产物。 想查某段逻辑是谁、什么时候、为什么改的，得确认这段代码确实被 git add 过且有提交历史；否则 gutter 空白、右键无菜单、GitLens: Show Line History 返回空列表，不是插件坏了，是 Git 没“见过”它。
为什么光标停在某行，左侧 gutter 没作者和 commit 信息
这是最常卡住的第一步。GitLens 默认不自动渲染 blame，必须同时满足三个条件：
-
gitlens.blame.lineEnabled为true（默认开启，但有人为省性能手动关了） - 当前文件不能是
Untracked files：终端执行git status，该文件需出现在modified或Changes to be committed列表中 - VSCode 左下角状态栏必须显示分支名（如
main），若显示No source control providers active，说明工作区根本没识别到.git - 某些后缀（如
.log、.tmp）被 GitLens 主动忽略，即使已git add也不会注入 blame
快捷键 Ctrl+Alt+H（Windows/Linux）或 Cmd+Option+H 可强制开关 blame 注释，比依赖右键更可靠。
右键没有 “GitLens: Show Line History” 怎么办
这个菜单项默认不注入任何上下文，不是 bug，是设计如此。别等它出现，直接走命令面板：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入并执行
GitLens: Show Line History - 结果为空？说明该行从未被单独修改过——可能是整块复制粘贴、函数重写、或从其他文件搬来，Git 无法建立行级连续性
- 只显示 1 条记录？大概率是这行自首次提交后就没被改过，或者后续变更全是空格/换行（被
gitlens.history.excludeTrivialCommits折叠）
想对比两个任意 commit，别只点右上角 “Compare with Previous Revision”
那个按钮只对比当前工作区与 HEAD~1，限制极多：
- 要求文件至少有两次提交；首次提交后无效果
- 当前文件若有未暂存修改（
git status显示modified），会直接报no previous revision - 选中几行再右键调用，它只 diff 这几行——但前提是这些行在
HEAD~1中真实存在；若上一版删了又重建，结果为空白 - 真要对比任意两个 commit（比如
abc123和def456），必须先打开GitLens: Open File Timeline，或进History Explorer视图，按住Ctrl（或Cmd）多选两个条目，再右键选Compare Revisions
性能卡顿或 CPU 占用飙升时优先关什么
大型单文件（如 >5000 行的 JSON、前端打包产物）会触发 GitLens 持续计算每行 blame，导致编辑器卡顿：
- 关闭
gitlens.codeLens.recentChange：这个会为每行计算“最近一次修改”，开销最大 - 关闭
gitlens.statusBar.enabled：右下角状态栏的 GitLens 统计会持续轮询 - 把
gitlens.blame.refreshInterval从默认 5000 毫秒拉长到 30000，减少高频刷新 - 禁用
gitlens.advanced.gitSubmodules.enabled（如果项目不用子模块），避免遍历额外仓库
真正难搞的是那些被重写过的历史——比如 rebase 或 filter-branch 后，部分旧提交在 History Explorer 里就彻底不可见了，GitLens 再强也读不到不存在的 commit 对象。
