Git插件在Sublime Text中不能“装了就用”，90%失败源于未满足三个硬性条件：必须安装wbond维护的官方Git插件、系统git命令需在PATH中或手动配置绝对路径、Sublime必须通过File→Open Folder…打开含.git/的项目根目录。
Git 插件在 Sublime Text 中不能“装了就用”，90% 的失败源于没满足三个硬性条件：插件是 wbond 维护的官方版本、系统 git 命令在 PATH 中或已手动配置路径、Sublime 必须通过 File → Open Folder… 打开含 .git/ 目录的项目根路径。
怎么确认 Git 插件装对了？只认 wbond 版本
Package Control 搜索 “Git” 会列出多个同名插件，但只有作者是 wbond、描述含 command-line git integration 的那个才支持 Git: Commit、Git: Push 等完整命令。GitGutter 只画行边标记，SublimeGit 已停更（2015 年），SideBarGit 功能残缺。安装时务必核对作者和描述，别点错。
为什么 Git 命令灰显或右键没菜单？根本不是插件问题
插件只在「当前窗口根路径下存在 .git/」时激活。常见误操作包括：
- 双击单个
.py或.js文件打开 —— 侧边栏无路径，插件不加载 - 用
File → Open打开子目录（如/src/utils/）—— 即使父目录有.git，插件也“隐身” - 终端能跑
git --version，但 Sublime GUI 启动时不继承 PATH（尤其 macOS）
验证方式：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Git: Status。如果命令不出现或灰显，说明还没进有效仓库上下文。
Git Pushing
下载
使用约定式提交信息暂存、提交和推送git更改。当用户想要提交和推送更改、提到推送到远程、或要求保存并推送工作时触发。也适用于用户说“推送更改”、“提交并推送”、“推送这个”、“推送到github”或类似git工作流程请求时。
“git is not recognized” 怎么修？路径配置优先级高于系统 PATH
插件默认调用系统 PATH 中的 git，但 GUI 启动常丢失 PATH。解决方法分平台：
-
macOS：终端运行
open -a "Sublime Text"启动；或手动配置Preferences → Package Settings → Git → Settings – User，填入：{"git_command": "/opt/homebrew/bin/git"}（路径用which git查） -
Windows：重装 Git for Windows，勾选
Add Git to the system PATH（选 “Use Git from Windows Command Prompt”）；若已装错，先 cmd 运行where git查路径，再填进上面的git_command -
Linux：桌面快捷方式启动常丢
$PATH，建议终端执行subl .；或修改sublime-text.desktop的Exec=行为为：Exec=env PATH=$PATH subl %F
装完后怎么验证能用？三步最小闭环
装完插件、配好路径、打开正确路径后，用以下三步验证是否真可用：
- 右键侧边栏项目文件夹 → 应出现
Git → Add子菜单 - 按
Ctrl+Shift+P输入Git: Status→ 应弹出当前未暂存/已暂存文件列表 - 修改一个文件，再执行
Git: Diff→ 应显示该文件的变更内容
真正容易被忽略的是：插件不处理合并冲突，也不自动拉取远程更新；所有交互都依赖你对 Git 命令本身的理解。别指望它替代终端，它只是把常用命令封装成快捷入口而已。
