sublime text 的 git 功能依赖系统 git 环境：需终端中 git --version 正常输出版本号，path 配置正确，安装 wbond 的 git 插件（非 gitgutter），并在 .git 项目根目录打开，必要时手动配置 git_command 路径。
Sublime Text 本身不带 Git 功能，装插件只是桥接系统 git —— 插件能用的前提，是终端里 git --version 能正常输出版本号；否则所有“菜单灰显”“右键没 Git 选项”“命令面板搜不到 Git: Commit”都是假问题，真问题是环境没通。
确认系统 git 是否真正可用
80% 的失败卡在这步。不是看 Sublime 控制台（Ctrl+`）能不能跑 git，而是必须在系统终端（Windows Terminal / macOS Terminal / Linux GNOME Terminal）里执行：
-
git --version必须返回类似git version 2.40.1的结果 - 如果报
'git' is not recognized或command not found，重装 Git 并严格检查 PATH： - Windows：安装时务必勾选 Add Git to the system PATH，推荐选 Use Git from Windows Command Prompt
- macOS（Homebrew）：
which git应返回/opt/homebrew/bin/git（Apple Silicon）或/usr/local/bin/git（Intel），但 Finder 启动的 Sublime 不读 shell 配置 - Linux：GUI 启动 Sublime 常丢失
/usr/bin，改用终端执行subl .启动项目
装对插件：只认 wbond 维护的 Git（不是 GitGutter）
GitGutter 只画标记线，不提供 Git: Commit、Git: Push 等命令。真正实现版本控制操作的是另一个插件：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Package Control: Install Package，回车等待列表加载 - 搜索
Git，只选作者是wbond、描述含 command-line git integration 的那个（图标是绿色叶子） - 装完后，必须在含
.git/目录的项目根目录下打开文件夹 —— 否则右键菜单不会出现Git → Add
手动指定 git_command 路径（macOS/Windows 高频失败点）
插件默认不继承 shell PATH，尤其 GUI 启动时容易找不到 git。路径配置不在全局设置，而在插件专属设置里：
- 菜单 →
Preferences → Package Settings → Git → Settings - 右侧（
Settings – User）中添加一行（注意 JSON 格式和引号）： - macOS：
{"git_command": "/opt/homebrew/bin/git"}（M1/M2）或{"git_command": "/usr/local/bin/git"}（Intel） - Windows：
{"git_command": "C:\Program Files\Git\bin\git.exe"}（双反斜杠）或{"git_command": "C:/Program Files/Git/bin/git.exe"}（正斜杠也行） - 保存后不用重启，但需关闭当前项目再重新打开，否则插件不重载配置
GitGutter 是辅助，不是替代：它不感知暂存区
如果你同时装了 GitGutter，它的标记（绿/蓝/红线）和 Git 插件的命令是两套逻辑：
- 绿色竖线 = 该行在 HEAD 中不存在，是纯新增（
git diff --no-index /dev/null file效果） - 蓝色竖线 = 该行在 HEAD 中存在，但内容已修改
- 红色横线 = 该行在 HEAD 中存在，但在当前工作区已被删除（标在删掉的那行上方）
-
git add后标记不会消失 —— GitGutter 永远只比对工作区与最近一次 commit，和暂存区无关 - 想看到暂存状态？得靠
git status命令，或配合 Terminus 插件开个内嵌终端
最常被忽略的其实是启动方式：macOS 用户从 Finder 双击 Sublime 图标，PATH 就断了；Windows 用户装 Git 时漏勾 PATH，重装也不补；这些都不是插件 bug，是环境透传没做实。路径填对、终端能跑、项目在仓库里——三者齐备，Git: Commit 才会出现在右键菜单里。
