必须装wbond维护的git插件、系统path中git可用、在含.git/的项目根目录打开,三者缺一不可;否则右键无菜单、命令面板搜不到git: status、快捷键灰显。

装对插件、路径通、项目根目录打开——这三步缺一不可,否则右键没菜单、命令面板搜不到 Git: Status、快捷键全灰显,不是插件坏了,是环境没搭对。
怎么确认装的是官方 Git 插件(不是 GitSavvy 或 SublimeGit)
Package Control 里搜 Git,只认作者是 wbond、描述含 command-line git integration 的那个。其他名字都别点:
-
GitSavvy:逻辑独立,和Git插件冲突,装了会导致Git: Status命令消失 -
SublimeGit:多年未更新,Sublime 4 上基本不响应,右键菜单空白 -
SideBarGit:只支持右键操作,无命令面板入口,Ctrl+Shift+P搜不到任何Git:命令
装完不用重启,但必须立刻验证:按 Ctrl+Shift+P 输入 Git: Status,能弹出面板才算成功激活。
为什么 git 命令在终端可用,Sublime 却报 "git" is not recognized
插件不带 git 可执行文件,它只从系统 PATH 里找。终端能跑 git --version,不代表 Sublime 能读到同一套环境变量:
- Windows:重装 Git for Windows,务必勾选
Add Git to the system PATH,推荐选Use Git from Windows Command Prompt - macOS:GUI 启动(双击图标)时
PATH不加载 shell 配置,Homebrew 装的git在/opt/homebrew/bin/git,得手动写死:Preferences → Package Settings → Git → Settings – User里填:{"git_command": "/opt/homebrew/bin/git"} - Linux:桌面启动的 Sublime 常丢失
~/.bashrc中的PATH,建议终端运行subl .启动,或改.desktop文件的Exec=env PATH=$PATH subl %F
验证方式:按 Ctrl+` 打开控制台,运行 import subprocess; subprocess.run(['git', '--version']),有输出即通。
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
为什么右键没 Git 菜单、Git: Status 灰显
插件只在“当前文件路径向上逐级查找能碰到 .git/ 目录”时才激活。这不是 bug,是设计行为:
- 双击打开单个
src/index.js文件 → 插件完全无感,哪怕它物理上属于某个仓库 - 用
File → Open Folder…选中含.git/的项目根目录 → 所有命令立即可用 - 在子目录里打开文件(如
project/src/)→ 只要该路径往上能找到.git/,就有效;但如果.git/在project/,而你打开的是other-project/src/,就不行
最简验证法:终端进项目根目录,执行 git status 有输出,再在 Sublime 里用 File → Open Folder… 重新打开这个目录。
常用操作和容易忽略的细节
这个插件本质是命令行封装,不简化 Git 工作流,也不自动帮你 add 全部改动:
-
Git: Status(Ctrl+Shift+H):显示暂存区 vs 工作区状态,灰色文件是未暂存,绿色是已暂存;光标停在文件名上按s暂存、u撤销、d查 diff -
Git: Commit(Ctrl+Shift+K):提交信息框里换行要用Shift+Enter,直接按Enter是提交,不支持-a或--amend -
Git: Diff(Ctrl+Shift+D):对比的是当前文件工作区 vs 暂存区,不是 vs HEAD;要看历史版本差异,得用Git: Browse Repository - 没有“一键 push”:必须先
Git: Add→Git: Commit→ 再手动终端跑git push,插件不封装推送逻辑
真正卡住人的从来不是功能少,而是误以为“装完插件就等于集成 Git”——它只负责调命令,git 本身的状态、分支、远程配置,一个字都不管。










