gitlens装不上或不显示blame信息，大概率因vscode版本低于1.70、市场源连不通、文件未纳入git索引；需升级vscode、切换市场源、执行git init/add/commit验证git上下文。
GitLens 装不上或装了不显示 blame 信息，大概率不是操作错，而是卡在三个硬性条件上：VSCode 版本低于 1.70、市场源连不通、文件没进 Git 索引。
插件装不上？先查 VSCode 版本和市场连接
VSCode 1.70 是 GitLens 的最低门槛。低于这个版本，插件会直接灰掉或提示“不兼容”。打开 Help → About 看一眼版本号，别猜——2026 年建议直接升级到 1.80+。
国内用户搜不到 GitLens，几乎全是市场源问题。微软默认的海外市场接口经常超时或被限流，跟插件本身无关。
- 关掉误启的代理：设置里搜
Proxy，确认http.proxy没填无效地址 - 手动换源：设置中搜
extensions.gallery，把serviceUrl和cacheUrl改成https://marketplace.visualstudio.com/_apis/public/gallery（结尾**不能有斜杠**） - 改完重启 VSCode，再搜
GitLens，认准作者是GitKraken的官方插件
装上了但行内 blame 不显示？验证 Git 上下文是否就位
GitLens 的行内 blame（右侧显示作者/时间/commit ID）只对已纳入 Git 管理的文件生效。新文件、.gitignore 排除项、没 git init 的目录，全都不触发。
别急着调设置，先做三件事：
- 终端执行
git status，确保目标文件出现在Changes to be committed或Modified列表里 - 看 VSCode 底部状态栏有没有分支名（比如
main），没有说明工作区根本没识别为 Git 仓库 - 右键编辑器空白处，菜单里若没有
GitLens: Toggle Blame Annotations，基本就是仓库未初始化或路径不对
快速修复：在项目根目录运行 git init（如果还没初始化）、git add .、git commit -m "init"，然后重新打开文件。
显示了但卡顿或信息不准？关 autoShow + 调刷新间隔
默认开启的 gitlens.blame.autoShow 会在每次光标移动时重算 blame，大文件（>500 行）或机械硬盘、网络盘上会明显拖慢响应，甚至让 VSCode 卡死。
推荐做法：
- 设置里搜
gitlens.blame.autoShow，设为false - 需要查某行历史时，右键该行 →
GitLens: Show Line Blame，或用快捷键Ctrl+Alt+H（Windows/Linux）/Cmd+Alt+H（macOS） - 非要常驻显示，把
gitlens.blame.refreshInterval从默认5000改成30000（30 秒） -
gitlens.advanced.blame.ignoreWhitespace默认为true，换行、空格增删这类改动不会触发 blame 更新
想查完整历史？优先用文件历史视图，别只盯 blame
行内 blame 只显示“最后一次改这行的人”，但很多场景要的是“这行经历过哪些修改”。这时候 Git: View File History（命令面板输入）比 blame 更可靠。
它能列出所有提交记录，点开任意一次，再点 Diff 标签就能看到具体改了哪几行。注意：如果 Diff 是灰色或空白，常见原因是该文件在那次提交中是二进制（如 .png）、被 .gitattributes 忽略，或当前工作区路径和仓库根不一致。
复杂点在于：blame 是“单点快照”，文件历史是“时间线回溯”，两者互补但不可替代。容易被忽略的是——你得先确保 git status 能列出这个文件，否则连历史视图都打不开。
