Git插件在Sublime中可用的前提是系统git命令路径被正确识别，GUI启动时需手动配置路径；仅安装wbond版Git插件；必须打开含.git目录的项目根目录；操作需严格按add→commit→push分步执行；设core.editor时必加-w参数。
Git 插件在 Sublime 中能用，前提是它真能调到你系统里那个可执行的 git 命令——不是“装了插件就自动好”，90% 的“命令灰显”“Git not found”都卡在这一步。
确认系统 git 是否可用且 Sublime 能读到
终端里 git --version 成功 ≠ Sublime 能调用。GUI 启动的 Sublime（双击图标）通常不继承 shell 的 $PATH，尤其 macOS 和 Linux 桌面环境。
- macOS：Homebrew 安装的
git默认在/opt/homebrew/bin/git；GUI 启动时找不到，必须手动指定路径 - Windows：运行
where git查真实路径，常见为C:\Program Files\Git\cmd\git.exe，注意反斜杠要双写或改用正斜杠 - Linux：桌面启动常丢
$PATH，建议用终端执行subl .，或修改sublime-text.desktop的Exec=行为
验证方式：按 Ctrl+` 打开 Sublime 控制台，输入 import subprocess; subprocess.run(['git', '--version'])，有输出即通。
只装 wbond 版 Git 插件，别碰 SublimeGit 或 GitSavvy
Package Control 里搜 Git，顶部显示作者是 wbond、描述含 command-line git integration 的那个才是官方维护版。其他名字近似的：
-
SublimeGit：最后更新在 2015 年，Sublime Text 4 上基本不可用 -
GitSavvy：逻辑完全不同，和Git插件冲突，装了会导致右键菜单消失
装完不用重启，但必须用 File → Open Folder… 打开一个含 .git/ 目录的项目根目录——单个文件或子目录下打开，插件根本不会激活。
用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
从暂存到提交：操作链不能断
这个插件不隐藏 Git 工作流，add → commit → push 必须分步执行，漏一步就推不上去。它也不默认提交全部改动，也不会自动识别未暂存文件。
- 先看状态：
Ctrl+Shift+P输入Git: Status，灰色文件是未暂存（modified/untracked），绿色是已暂存（staged） - 暂存文件：光标放灰色文件名上，
Ctrl+Shift+P→Git: Add File；或多选后右键 →Git → Add File - 提交：
Ctrl+Shift+P→Git: Commit，弹出输入框，换行用Shift+Enter；不支持-a或--amend
首次 push 前必须设上游分支，否则报错；命令面板没有一键 push，得靠 Git: Push 或手动进终端跑 git push -u origin main。
让 Sublime 成为 Git 默认编辑器：-w 参数不能少
配置 core.editor 是为了让 git commit、git rebase 这类命令唤起 Sublime，而不是弹 Vim 或记事本。
- macOS：运行
git config --global core.editor "subl -n -w"，-n开新窗口，-w强制 Git 等待你保存并关闭文件后再继续 - Windows：路径含空格需加引号，如
git config --global core.editor "'C:/Program Files/Sublime Text/subl.exe' -n -w" - Linux：确保
subl在$PATH，再执行同上命令
漏掉 -w 是最常见错误：Git 会立刻读空文件提交，你连输入框都看不到。验证方式是执行 git commit --allow-empty -m "test" 后立即 git commit --amend，看是否唤起 Sublime。
.git/」时才激活，且所有命令都基于当前文件路径向上找最近的 .git/。不在仓库里，快捷键灰显、右键无菜单，不是 bug，是设计如此。 
