GitLens是通用Git增强工具，非Python专用；VSCode需1.70+版本，国内用户需检查代理或切换市场源；行内blame仅对已暂存文件生效；关闭autoShow可缓解卡顿；查行历史应优先用文件历史视图而非blame。
GitLens 不是 Python 专用插件，它是个通用 Git 增强工具，和 Python 语言本身无关。但你在 Python 项目里用它查提交历史、看谁改了哪行、对比分支差异，完全没问题——只要项目是 Git 仓库就行。
VSCode 版本低于 1.70 就装不上 GitLens
不是你操作错，是硬性门槛。打开 Help → About 看版本号，低于 1.70 的 VSCode 会直接显示“不兼容”或安装后灰掉。2026 年建议直接升级到 1.80+（官网最新版），顺便解决部分 Git 集成 bug。
搜不到 GitLens？先检查市场连通性
国内用户常见现象：搜索框输 GitLens，结果为空或加载转圈。这不是插件下架，而是 VSCode 默认调用微软海外市场接口，不稳定。
- 关掉 VSCode 里误启的代理（Settings → Application → Proxy，确认没填无效地址）
- 手动换源：在设置中搜
extensions.gallery，把serviceUrl和cacheUrl改成https://marketplace.visualstudio.com/_apis/public/gallery（注意结尾**不要加斜杠**） - 改完重启 VSCode，再搜
GitLens，认准作者是GitKraken的官方插件
GitLens 行内 blame 不显示？八成没进 Git 上下文
右侧行号旁不显示作者/时间/commit ID，别急着调设置。先验证三件事：
- 终端执行
git status，确保当前文件在Changes to be committed或Modified列表里（新文件没git add过就不算） - VSCode 底部状态栏有没有分支名（比如
main或dev）？没有说明工作区根本没识别为 Git 仓库 - 右键编辑器空白处，菜单里有没有
GitLens: Toggle Blame Annotations？没有大概率是仓库未初始化或路径不对
快速修复：在终端跑 git init（如果还没初始化）、git add .、git commit -m "init"，然后重新打开文件。
Github Xiaoshu
下载
使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。
立即学习“Python免费学习笔记（深入）”；
大文件卡顿、光标一动就卡？关掉 gitlens.blame.autoShow
默认开启的自动 blame 会在每次光标移动时重算，500 行以上的 Python 文件（比如数据处理脚本）在机械硬盘或远程卷上会明显拖慢响应。
- 设置里搜
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 更新——这点容易被当成“没生效”，其实是设计如此。
