git插件仅调用系统git命令,非开箱即用:需确保终端git--version可用、sublime通过openfolder打开含.git的根目录、插件认准wbond维护的官方git版本。

Git 插件不是“装上就能同步代码”的自动工具,它只是调用你系统里已有的 git 命令——装错、路径不对、项目没进对目录,都会导致右键没菜单、命令灰显、报 git not found。
怎么确认系统 git 已就位?别跳过这步
Sublime 的 Git 插件不带 git,只负责“喊一声”,真正干活的是你终端里那个 git。如果终端输 git --version 报错,插件必然瘫痪。
- macOS:用
brew install git,别依赖 Xcode 自带的老版本;验证:which git应该返回类似/opt/homebrew/bin/git - Windows:安装 Git for Windows 时,必须勾选
Add Git to the system PATH(推荐选 “Use Git from Windows Command Prompt”);验证:where git要能输出路径 - Linux:
sudo apt install git(Debian/Ubuntu)或sudo dnf install git(Fedora),确保git在$PATH中
⚠️ 注意:双击图标启动 Sublime 时,GUI 环境可能读不到 shell 的 PATH。macOS 可终端执行 open -a "Sublime Text";Linux 推荐用 subl . 启动。
装哪个 Git 插件?认准 wbond 版本
Package Control 里搜 Git,会出现一堆名字带 Git 的插件。真正支持 Git: Commit、Git: Push 等完整命令的,只有 wbond 维护的那个官方插件:
- 名字就是纯
Git,描述含command-line git integration - 别选
GitGutter(只画行边标记)、SideBarGit(功能不全)、SublimeGit(2015 年停更,不兼容 ST4) - 安装方式统一:按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)→ 输入Package Control: Install Package→ 搜Git→ 点击安装
装完不用重启,但必须在正确路径下才生效。
使用约定式提交(Conventional Commits)从 Git 历史记录中生成结构化变更日志,支持多种格式、AI 增强型描述以及可自定义的范围……
为什么右键没 Git 菜单?90% 是路径问题
Git 插件只在「当前窗口根目录下存在 .git/」时才激活。它不会向上查找,也不会识别子目录里的仓库。
- 必须用
File → Open Folder…打开整个项目根目录(比如/home/user/my-project/),不能双击单个.py文件打开 - 侧边栏顶部显示的路径里得有
.git(如/home/user/my-project/.git) - 按
Ctrl+Shift+P输入Git: Status,如果命令不出现或灰显,说明还没进有效仓库
常见误操作:在 /src/utils/ 下打开文件夹 → 插件直接“隐身”。
插件装了但报 “git not recognized” 怎么办?
这是 Sublime 启动时没继承到你的 shell PATH。解决方式分平台:
- macOS:终端运行
open -a "Sublime Text"启动;或手动配置:Preferences → Package Settings → Git → Settings – User,填入:{"git_command": "/opt/homebrew/bin/git"} - Windows:重装 Git for Windows,务必勾选 PATH;或同样在 Settings – User 里写死路径:
{"git_command": "C:\Program Files\Git\bin\git.exe"} - Linux:改桌面启动器(
sublime-text.desktop),把Exec=行改成:Exec=env PATH=$PATH subl %F
路径必须精确到可执行文件,不能只写目录;斜杠方向别写反(Windows 用双反斜杠或正斜杠都行)。
真正的难点不在“怎么装”,而在让 Sublime 和你的系统环境、项目结构对齐——三者缺一,Git 插件就只是个摆设。










