sublime text 的 git 功能依赖系统 git 可执行文件和 wbond 维护的 git 插件；需确保终端中 git --version 可运行、插件正确安装、路径在设置中手动指定，否则命令不可用或菜单灰显。
Sublime Text 本身不带 Git 集成，所有功能都依赖外部 git 可执行文件 + 插件桥接。只要 git 在终端能跑、插件装对、项目在 .git 目录下，Git 命令就能用；否则必报 "git" is not recognized 或菜单灰显——这不是插件问题，是环境没通。
确认系统 git 是否真正可用
这是最常被跳过的一步，但 80% 的“插件不生效”都卡在这儿。
- 在终端（不是 Sublime 控制台）运行
git --version，必须有输出；若报错，重装 Git 并确保 PATH 生效 - Windows 用户检查安装时是否勾选了 Add Git to the system PATH（推荐选 “Use Git from Windows Command Prompt”）
- macOS 用户用 Homebrew 安装后，
which git返回的是/opt/homebrew/bin/git，但 Finder 启动的 Sublime 不会加载 shell 配置，需手动指定路径 - Linux 用户如果从 GUI 启动 Sublime，PATH 可能不包含
/usr/bin或/usr/local/bin，建议改用终端启动：subl .
装对插件：认准 wbond 维护的 Git（不是 GitGutter 或 SideBarGit）
GitGutter 只显示行级变更标记，SideBarGit 功能残缺且已停止更新；真正支持 Git: Commit、Git: Push 等完整命令的是官方插件 Git，作者是 wbond。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package - 搜索
Git，只选描述含 command-line git integration、作者为wbond的那个 - 装完后打开一个已有
.git目录的项目，右键应出现 Git → Add 子菜单；没有？说明插件未激活或路径不通
路径配置：Windows/macOS 用户常需手动填 git_command
插件默认调用 git 命令，但它不读 shell 的 PATH，尤其 macOS GUI 启动、Windows 某些 PATH 注册异常时会失败。
- 进
Preferences → Package Settings → Git → Settings - 在用户设置中加一行（路径按你本地实际调整）：
{ "git_command": "/opt/homebrew/bin/git" } - Windows 示例：
{ "git_command": "C:\Program Files\Git\bin\git.exe" }（注意双反斜杠） - 改完保存，重启 Sublime 或重新打开项目文件夹
常用操作与容易忽略的限制
这个插件是轻量 CLI 封装，不是 IDE，很多“理所当然”的事它不做。
-
Git: Commit不支持-a或--amend，想跳过git add直接提交所有修改？得先手动执行Git: Add或切终端 -
Git: Diff默认对比工作区和暂存区，若文件未git add过，看到的是空 diff —— 这不是 bug，是 Git 本身行为 - 中文 commit message 乱码？关掉 Git 的 pager：
git config --global pager.log false（Sublime 日志面板不依赖less） - 所有命令只对当前文件所在仓库生效，不支持跨文件夹批量操作；右键菜单/快捷键在非 Git 目录下自动禁用，别怀疑快捷键失效
真正麻烦的从来不是装插件，而是让 Sublime 读到你的 git。PATH 透传问题在 macOS 和某些 Windows 环境里极隐蔽，改了配置不重启 Sublime、或改了系统 PATH 没重开终端，都会导致前功尽弃。
