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 看一眼真实状态。
