SublimeGit 已停更且不兼容 Sublime Text 4，应使用 wbond 官方 Git 插件；需通过 Open Folder 打开含 .git 的项目目录才能激活命令；“git not recognized” 需手动配置 git_binary 路径；行号旁标记由 GitGutter 提供，非 Git 插件本身功能；首次 push 需手动设上游分支。

SublimeGit 不是 Sublime Text 官方推荐或持续维护的 Git 插件，它早已停止更新（最后提交在 2015 年），且与当前 Sublime Text 4（2026 年主流版本）存在兼容性问题：命令面板搜不到 Git: Status、右键无菜单、状态栏不显示分支，基本不可用。

你要用的是官方维护的 Git 插件（作者 wbond），不是 SublimeGit。装错名字是 90% 用户卡住的第一步。

---

为什么“Git: Status”命令不出现？

不是插件没装好，是 Sublime 没识别到 Git 仓库上下文。

• 插件只在「当前窗口的根路径下存在 .git/ 目录」时才激活——必须用 File → Open Folder… 打开整个项目目录，不能双击单个 .js 或 .py 文件
• 侧边栏必须能看到项目文件树，且顶部显示路径中包含 .git
• 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）输入 Git: Status，如果命令灰显或根本不列出来，说明还没进仓库

“git is not recognized” 错误怎么修？

插件不自带 git，它只调系统 PATH 里的可执行文件。终端能跑 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_binary": "/opt/homebrew/bin/git" }

• Windows：重装 Git for Windows，务必勾选 Add Git to the system PATH；已装错就运行 where git 看输出路径，再填进上面的 git_binary 配置里
• Linux：桌面启动的 Sublime 通常不加载 ~/.zshrc，建议终端执行 subl .，或修改 sublime-text.desktop 的 Exec= 行为：Exec=env PATH=$PATH subl %F

怎么让左边行号旁显示 + ~ − 标记？

Git 插件本身不提供视觉标记，那是 GitGutter 的事。装了 Git 却看不到颜色标记，不是配置错了，是根本没装 GitGutter。

• 安装后默认不标未跟踪文件（??），如需显示新增文件，在 Preferences → Package Settings → GitGutter → Settings – User 中加：

  { "show_untracked": true }

• 性能敏感时可关实时刷新："live_mode": false，只在保存或切换标签页时更新 gutter
• 确认文件路径在 .git/ 子目录下，且至少执行过一次 git add（否则全是 untracked，GitGutter 默认跳过）

提交后 push 报 “no upstream branch” 怎么办？

Git: Push 只执行 git push，不做自动关联。它不会替你设上游分支，这是设计使然，不是 bug。

• 首次推送必须手动指定：git push -u origin main（或 master）
• 之后再用 Git: Push 就能直接推了
• 不想切终端？先用 Git: Custom 命令，输入完整命令：push -u origin main

真正容易被忽略的点是：Sublime 的 Git 集成是“命令代理”，不是“GUI 替代”。它不隐藏 Git 语义，也不绕过工作区/暂存区概念。你得理解 git add 和 git commit 的边界，否则看到“文件改了但没出现在 Git: Status 里”，第一反应不该是插件坏了，而是该去终端敲 git status --porcelain 看一眼真实状态。