必须安装作者wbond、描述含command-line git integration的git插件;需通过file→open folder打开含.git/的项目根目录;并确保系统path中git可用或手动配置git_command路径。

装 Git 插件本身不难,难的是装完发现 Git: Status 不出现、右键没菜单、控制台报 "git" is not recognized——90% 的问题不是插件没装对,而是环境没对齐。
怎么确认装的是官方 Git 插件(不是 GitGutter 或 SublimeGit)
Sublime Text 官方持续维护的 Git 插件只有一个,名字就叫 Git,作者是 wbond。搜“Git”时列表里会出现多个同名插件,必须认准描述含 command-line git integration、作者明确写 wbond 的那个。
- 别选
GitGutter:只显示行级变更标记(+ / − / ▶),不提供Git: Commit等命令 - 别选
SublimeGit:2015 年起停更,Sublime Text 4 上基本不可用 - 别选
SideBarGit:功能残缺,不支持 push/pull 等核心操作 - 装完后按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Git: Status——能列出且不灰显,才算真正装对
为什么 Git 命令面板里不显示、右键没菜单
插件不会自动激活,它只在「当前窗口根路径下存在 .git/ 目录」时才工作。这不是 bug,是设计逻辑。
- 必须用
File → Open Folder…打开整个项目目录,不能双击单个.js或.py文件打开 - 侧边栏顶部路径必须是仓库根目录(例如
/Users/me/project/),且该路径下有.git/子目录 - 在子目录里打开(比如
/src/utils/)或用Project → Add Folder to Project添加子路径,插件都不会识别上下文 - 打开后按
Ctrl+Shift+P输入Git: Status,如果命令灰显或根本不出现在列表里,说明还没进有效仓库
如何解决 "git" is not recognized 错误
插件不自带 git 可执行文件,它只调系统 PATH 里的 git。终端能跑 git --version ≠ Sublime 能继承这个环境。
- Windows:重装 Git for Windows,务必勾选
Add Git to the system PATH;若已装错,运行where git查路径,然后在Preferences → Package Settings → Git → Settings – User中填:{"git_command": "C:/Program Files/Git/cmd/git.exe"} - macOS:GUI 启动(双击图标)时 PATH 默认只有
/usr/bin,Homebrew 安装的git在/opt/homebrew/bin/git就被忽略;要么从终端运行open -a "Sublime Text",要么在 Settings – User 里硬编码:{"git_command": "/opt/homebrew/bin/git"} - Linux:桌面启动常丢
$PATH,建议终端执行subl .;或修改sublime-text.desktop的Exec=行为:Exec=env PATH=$PATH subl %F - 验证是否生效:按
Ctrl+`打开控制台,输入import subprocess; subprocess.run(['git','--version']),有输出即成功
安装前必须确保 Package Control 已就位
几乎所有 Git 相关插件都依赖 Package Control。如果 Ctrl+Shift+P 输入 Package Control: Install Package 没反应,说明它没装好或失效了。
- 去
https://packagecontrol.io/installation复制对应 Sublime Text 版本(尤其是 Sublime Text 4 必须用 Package Control 4.x)的 Python 安装代码 - 粘贴进 Sublime 的控制台(
View → Show Console)执行 - 装完重启 Sublime,再按
Ctrl+Shift+P输入Package Control: List Packages,能列出已装插件即 OK - 别用所谓“绿色版”或第三方汉化包,它们常屏蔽 Package Control 的网络请求,导致插件列表空白
最容易被忽略的点是:插件装对了、git 路径也配好了,但用户习惯性双击某个文件打开 Sublime,而不是用 Open Folder 进入仓库根目录——这时候所有 Git 命令都处于“隐身”状态,连错误提示都不会出现。











