GitLens 和 Git Graph 是当前最实用、维护最活跃的两个 Git 插件，装这两个基本覆盖 90% 的日常需求。其他插件如 Git History 或 GitHub Pull Requests 属于按需补充，不建议一上来全装。
怎么在 VSCode 里搜到并安装 GitLens
打开 VSCode，按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）进入扩展面板，在搜索框里直接输 GitLens —— 注意别输错成 Git Lens（带空格）或 gitlens（小写开头有时搜不到）。官方发布者是 eamodio，认准这个作者名和“Git supercharged”副标题。
点击“Install”，安装完成后无需重启，编辑器右上角会立刻出现“GitLens”图标，光标悬停在代码行时能看到提交作者、时间、上次修改的 commit hash。
常见错误现象：
- 搜不到
GitLens：检查是否开了代理或网络受限；可尝试切换 VSCode 内置的扩展市场区域（设置里搜extensions.autoUpdate关掉再重试） - 安装后没反应：大概率是
git.path没配对，VSCode 找不到本地git命令，见下一条
为什么装完 GitLens 还提示 “Git not found”
VSCode 不自带 git，它只是调用系统已安装的 git 可执行文件。即使你装了 Git for Windows 或 Homebrew 安装的 Git，VSCode 也可能因为 PATH 没生效或路径含空格/中文而找不到。
手动指定路径最稳：
- 先确认
git能在终端跑通：打开 VSCode 内置终端，输入git --version，有输出即说明已安装 - 按
Ctrl+Shift+P→ 输入Preferences: Open Settings (JSON)→ 在settings.json里加一行："git.path": "C:\Program Files\Git\bin\git.exe"
（Windows）或"git.path": "/usr/local/bin/git"
（macOS/Linux） - 路径必须是
git.exe或git文件本身，不是目录；反斜杠在 JSON 里要双写
改完保存，重新加载窗口（Ctrl+Shift+P → Developer: Reload Window），状态栏左下角应该立刻显示当前分支名。
Git Graph 怎么装？和 GitLens 有什么区别
Git Graph 是纯可视化分支图谱工具，和 GitLens 功能不重叠但互补。它不看“谁改的哪一行”，而是帮你一眼看清：main 分支在哪、feature/login 是从哪次提交分出来的、有没有未合并的 commit、冲突点在哪。
安装方式一样：扩展面板搜 Git Graph，认准作者 mhutchie，点 Install。装完左侧活动栏会出现一个分支状图标，点开就是交互式提交图。
使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。
关键差异：
-
GitLens强在代码级追溯（hover 行号看历史），适合 Code Review -
Git Graph强在仓库级导航（拖拽缩放看分支拓扑），适合 merge / rebase 决策 - 两者都依赖正确配置的
git.path，且都不需要额外配置就能用
内网或离线环境怎么装 GitLens
不能联网时，得手动下载 .vsix 文件再本地安装。核心是拼对 Marketplace 下载链接：
比如你要下 GitLens 最新版（2026 年 8 月最新稳定版是 14.12.1），作者 ID 是 eamodio，Windows x64 用户就拼：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/eamodio/vsextensions/gitlens/14.12.1/vspackage
把这串粘贴进浏览器下载，得到 eamodio.gitlens-14.12.1.vsix 文件。
然后在 VSCode 里：Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中该文件 → 确定。
注意点：
- 链接里的
publishers/xxx必须和插件详情页 URL 里的完全一致（比如eamodio不是e-amodio） - 版本号要去插件详情页找，别凭记忆写；旧版可能不兼容 VSCode 1.85+
- Linux/macOS 用户注意
targetPlatform参数，x64 系统不用加，ARM64 则要补?targetPlatform=linux-arm64类似参数
离线安装后，插件行为和在线安装完全一致，但不会自动更新 —— 这反而是内网环境想要的稳定性。
