GitLens插件必须通过VS Code扩展系统安装，不能复制文件或手动解压；离线安装需确保vsix包含正确平台标识（如win32-x64）、完整路径调用code --install-extension命令，并验证Git已安装且git.path配置正确，否则插件无法激活。
GitLens 插件必须通过 VS Code 扩展系统安装，不能靠复制文件或手动解压生效；离线安装虽可行，但绝大多数人遇到的“装不上”问题都出在路径、版本匹配或 Git 依赖缺失上。
在线安装是最稳的方式
只要网络通畅，直接在 VS Code 内完成安装，几乎零失败率。关键点不是“能不能点安装”，而是安装后能否被正确激活——这取决于 Git 命令是否可用。
- 先确认终端能运行
git --version，返回类似git version 2.40.1才算达标；若报错command not found: git，得先装 Git 并把git加入系统 PATH - 在 VS Code 中按
Ctrl+Shift+X（Windows/Linux）或Cmd+Shift+X（macOS）打开扩展面板 - 搜索框输入
GitLens，认准发布者是GitKraken（ID：eamodio.gitlens），点“Install” - 安装完不用重启 VS Code，插件会自动激活；可立即按
Ctrl+Shift+P输入GitLens: Toggle File Blame Annotations测试是否响应
离线安装容易卡在 vsix 文件路径和平台标识上
离线安装不是简单把 .vsix 文件拖进 VS Code，VS Code 不识别未签名/平台不匹配的包。你得确保下载的 vsix 包名里含明确平台标识，否则 code --install-extension 会静默失败。
Evez Github Manager
下载
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
- 去 Visual Studio Marketplace 页面找 GitLens，点 “Version History”，选一个稳定版（如
2025.12.2504） - 从 URL 提取 publisher ID（
eamodio）、extension name（gitlens）、version（2025.12.2504） - 拼下载地址时必须加
targetPlatform参数：比如 macOS Intel 是darwin-x64，Windows x64 是win32-x64，漏掉或写错会导致下载的 vsix 实际不兼容 - 安装命令必须带完整路径：例如
code --install-extension ./eamodio.gitlens-2025.12.2504-darwin-x64.vsix，不能只写文件名
装完没反应？大概率是 GitLens 没拿到 Git 可执行路径
GitLens 启动时会尝试调用 git 命令获取仓库状态。即使你本地有 Git，VS Code 的 GUI 启动方式（比如从 Dock 或开始菜单点开）可能读不到 shell 的 PATH，导致插件认为“Git 不可用”而禁用部分功能。
- 在 VS Code 终端里运行
which git（macOS/Linux）或where git（Windows），记下路径（如/usr/local/bin/git） - 打开 VS Code 设置（
Ctrl+,），搜git.path，填入上面拿到的绝对路径 - 或者改用终端启动 VS Code：
code .，这样它能继承当前 shell 的环境变量 - 检查状态栏左下角是否有 Git 分支名；没有的话，说明 GitLens 还没识别到仓库上下文，此时所有图形化功能（blame、compare、worktrees）都会灰掉
最常被忽略的一点：GitLens 的许多高级功能（比如 Worktrees、Compare Commits）只在项目根目录下有 .git 文件夹时才激活——如果你打开的是子文件夹而非整个仓库，插件会安静地退场，不会报错也不会提示。
