能用Git插件的前提只有三个:系统git命令可用、装对wbond官方Git插件、项目在.git目录下打开;其他问题基本源于这三者之一未满足。

能用的前提就三个:系统 git 命令可用、插件装对了、项目在 .git 目录下打开。其他所有“命令灰显”“右键没菜单”“报 Git not found”,基本都卡在这三件事上某一个环节。
确认系统 git 是否真能被 Sublime 调用
插件不带 git,只调你本地的 git 可执行文件。终端里 git --version 能返回版本号,不等于 Sublime 就能用。
- macOS 用户:GUI 启动(双击图标)时 PATH 通常只有
/usr/bin,Homebrew 安装的 git 在/opt/homebrew/bin/git就会被忽略;要么从终端运行open -a "Sublime Text",要么在Preferences → Package Settings → Git → Settings – User里硬写路径:{"git_command": "/opt/homebrew/bin/git"} - Windows 用户:重装 Git for Windows,务必勾选 Add Git to the system PATH;已装错就手动把
C:\Program Files\Git\cmd加进系统环境变量,再重启 Sublime 和终端 - Linux 用户:桌面启动的 Sublime 一般不加载
~/.bashrc或~/.zshrc,建议直接用终端执行subl .启动项目
只装 wbond 维护的官方 Git 插件
搜 “Git” 会出来一堆名字相似的包,但只有作者是 wbond、描述含 command-line git integration 的那个才是真插件。装错等于白忙。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Package Control: Install Package回车 - 等列表加载完,输入
Git,顶部第一个、作者显示wbond的才是——不是GitSavvy、SublimeGit、SideBarGit,也别选GitGutter(它只画标记线,不提供提交命令) - 装完必须重启 Sublime,尤其刚装完 Package Control 后
必须在含 .git 的项目根目录打开文件夹
插件靠向上遍历路径找 .git/ 目录来判断是否处于仓库中。单个文件打开、子目录打开、甚至用 .sublime-project 打开,都不行。
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
- 正确做法:菜单栏
File → Open Folder…,选包含.git/的完整项目根目录 - 验证方式:按
Ctrl+Shift+P输入Git: Status,如果命令可选且不灰显,说明上下文已激活 - 右键菜单里没
Git → Add?大概率就是没在根目录打开,侧边栏看到的路径树必须以.git所在目录为顶层
常用操作和容易被忽略的细节
插件本身不渲染状态,只调命令。想看改了哪几行,得另外装 GitGutter;想让新增文件也标出来,得在它的设置里加 {"show_untracked": true}。
-
Git: Commit会弹出临时 buffer 写 commit message,保存即提交;别关窗口,按Ctrl+S就生效 - 中文 commit message 卡顿或乱码?在
git config --global core.pager cat禁用分页器 - 插件默认不自动刷新状态栏,stash 或 pull 后看不到变化是正常的,手动触发
Git: Refresh Status或重启 Sublime - macOS 上手动配置
git_command后,得关闭当前项目再重新Open Folder,否则配置不重载
最常被跳过的其实是第一件事:确认 git --version 在终端能跑,不代表 Sublime 能调到同一个 git。路径、启动方式、GUI 环境变量继承,这三个点任何一个断掉,后面全白搭。










