GitGutter仅显示工作区与HEAD的差异标记,不执行任何Git操作;绿色竖线表示新增行,蓝色竖线表示修改行,红色横线表示删除行;提交、推送等需另装wbond的Git插件。

GitGutter 只显示变更标记,不执行任何 Git 操作;想提交、推送、拉取,必须装另一个插件——wbond 维护的 Git 插件。
GitGutter 安装后没反应?先确认 git 是否真能用
80% 的“没标记”问题出在系统 git 本身不可用。GitGutter 不调用命令行,但它依赖 git 二进制文件存在且可被检测到。
- 在终端(不是 Sublime 控制台)运行
git --version,必须输出版本号;若报错,重装 Git 并确保 PATH 生效 - Windows 用户安装时务必勾选 “Add Git to the system PATH”,推荐选 “Use Git from Windows Command Prompt”
- macOS 用户用 Homebrew 安装后,
which git返回/opt/homebrew/bin/git,但 GUI 启动的 Sublime 不读 shell 配置,需手动指定路径 - Linux 用户从桌面环境启动 Sublime 时 PATH 常缺失
/usr/bin,建议改用终端启动:subl .
GitGutter 的路径配置写在哪?不是 Settings – Default
GitGutter 默认不读系统 PATH,尤其 macOS 和 Windows 某些注册表异常时会失效。必须在用户设置里显式填 git_binary。
- 菜单 → Preferences → Package Settings → GitGutter → Settings
- 在右侧(Settings – User)中添加一行(注意双反斜杠或正斜杠):
{"git_binary": "C:\Program Files\Git\bin\git.exe"}(Windows){"git_binary": "/opt/homebrew/bin/git"}(macOS) - 保存后无需重启,但需重新打开当前文件夹(或关闭再打开项目)才能触发重载
- 路径错误会导致左侧边栏完全无标记,且控制台(
Ctrl+`)可能静默失败,不会弹提示
绿色/蓝色/红色标记对应什么操作?别和暂存区混淆
GitGutter 显示的是工作目录与 HEAD 的差异,和 git add 无关——它不感知暂存区状态。
OpenClaw 技能 — 给定一个 GitHub 仓库 URL,自动解析出 owner/repo 名称,发现其中的 YAML/properties 配置文件及其配对的中文字段说明;在 `workspace/{repo}/` 目录下按同步日期(格式为 `YYYY-MM-DD`)创建时间戳子目录;写入 `.openclaw-config-state.json` 状态文件。每次用户提问前,先比对远程仓库当前 ref(如 `main` 或 `master`)的最新提交 SHA 与本地状态文件中记录的 SHA:
-
绿色竖线:该行是
HEAD中没有、但当前文件里新增的内容(等价于git diff --no-index /dev/null file新增部分) -
蓝色竖线:该行在
HEAD中存在,但内容已被修改 -
红色横线:该行在
HEAD中存在,但在当前文件中已被删除(标记出现在被删行上方) - 如果刚
git add过,标记不会消失——GitGutter 不刷新暂存状态,只比对工作区与最近一次 commit
想提交代码?GitGutter 做不了,得靠 wbond 的 Git 插件
GitGutter 是纯视觉辅助,所有 Git 命令(commit/push/status)都得靠另一个插件。很多人装了 GitGutter 就以为“Git 集成了”,结果右键找不到 Git 菜单。
- 按
Ctrl+Shift+P输入Package Control: Install Package,搜Git,只认准作者是wbond、描述含command-line git integration的那个 - 装完后,必须打开一个含
.git/目录的文件夹,否则右键菜单里 Git 项灰显 -
Git: Commit不支持-a或--amend,想跳过git add直接提交全部修改?得先手动执行Git: Add或切终端 - 这个插件本质是 CLI 封装,不处理合并冲突,也不提供图形化 diff —— 出现 conflict,仍得人工打开文件核对
最容易被忽略的一点:GitGutter 和 Git 插件可以共存,但它们彼此独立;一个管“看改了哪几行”,一个管“怎么提交”。路径配置也要分别设——git_binary 是 GitGutter 的,git_command 是 Git 插件的,填错位置就全失效。










