sublimegit 不是推荐安装的 git 插件,它早已停止维护且与 sublime text 4 和 package control 4.x 不兼容;应安装官方 git 插件(作者 wbond),确认方式为命令面板中 package control: install package 后搜索 git,首个结果作者须为 wbond,描述含 command-line git integration,安装后需确保 git 在系统 path 中、项目以文件夹形式打开,并能正常执行 git: status 命令。

SublimeGit 不是推荐安装的 Git 插件,它早已停止维护,且与当前 Sublime Text 4 和 Package Control 4.x 不兼容。
你真正该装的是官方 Git 插件(作者 wbond),不是 SublimeGit、SideBarGit 或 GitSavvy。搜到这些名字就停手——它们要么功能残缺,要么会和主 Git 插件冲突,导致右键菜单消失、Git: Status 灰显、命令面板无响应。
为什么 SublimeGit 装了也白装?
它最后一次更新是 2017 年,不支持 Sublime Text 4 的 Python 3.8+ 运行时;插件内部调用的 Git API 已过期,遇到现代 Git 版本(比如 2.40+)会直接抛 AttributeError: 'NoneType' object has no attribute 'split';更关键的是,它没接入 Package Control 的依赖管理机制,无法自动适配 Sublime Text 启动时的环境变量加载顺序。
怎么确认自己装的是真 Git 插件?
打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),输入 Package Control: Install Package → 回车 → 等几秒 → 输入 Git:
使用 gh project CLI 管理 GitHub Projects v2。在代理需要列出待办事项、设置项目字段(如状态、迭代、优先级等)时使用此技能。
- 顶部第一个结果必须显示作者为
wbond,描述含command-line git integration - 不要选名字带
SublimeGit、GitSavvy或SideBarGit的条目 - 安装后重启 Sublime Text,再打开命令面板搜
Git: Status—— 能执行且返回类似On branch main\nYour branch is up to date...才算成功
git 命令找不到?别怪插件,怪 PATH
插件本身不带 git 可执行文件,它只调系统 PATH 里的 git。终端里能跑 git --version,但 Sublime 里报 "git" is not recognized,说明环境变量没透过去:
- Windows:重装 Git for Windows,务必勾选
Add Git to the system PATH,选 “Use Git from Windows Command Prompt” - macOS:GUI 启动的 Sublime 不读
~/.zshrc,要么从终端运行open -a "Sublime Text",要么在Preferences → Package Settings → Git → Settings – User里硬写:"git_command": "/opt/homebrew/bin/git" - Linux:桌面快捷方式启动时 PATH 不完整,建议用终端执行
subl .,或修改.desktop文件的Exec=env PATH=$PATH subl %F
插件激活失败?99% 是路径没对
Git 插件只在“当前编辑文件所在路径向上能找到 .git/ 目录”时才激活。这不是 bug,是设计:
- 双击打开单个
src/main.js文件 → 插件完全无感 - 必须通过
File → Open Folder…选中包含.git/的项目根目录 - 验证方式很简单:命令面板输
Git: Status,如果返回No git repository found,就别折腾快捷键了
装完别急着用,先确保三件事:Package Control 装对了、git 在 PATH 里、项目是以文件夹形式打开的。漏掉任何一环,插件就只是个静默的图标。










