Sublime怎么使用Git插件_Sublime Git集成教程【协作】

git插件报“git not found”是因sublime未继承系统path，macos需终端启动，windows需确认git加入path，所有平台可手动配置git_binary路径；右键无git菜单是因未以项目目录打开；gitgutter才显示代码变更图标；推送前须设置upstream分支。

不是插件坏了，是 Sublime 找不到你系统里的 git 命令——它不自带 Git，只负责调用。终端里 git --version 能跑，不代表 Sublime 能继承这个环境。

macOS 用户：GUI 启动（双击图标）时 PATH 往往只有 /usr/bin，Homebrew 装的 git 在 /usr/local/bin/git 就被忽略了；必须用终端启动：open -a "Sublime Text" 或 /Applications/Sublime Text.app/Contents/MacOS/Sublime Text
Windows 用户：检查是否在安装 Git for Windows 时勾选了 Add Git to the system PATH；已安装就重启命令提示符和 Sublime，再运行 where git 看路径有没有出现在结果里
所有平台都可手动指定：打开 Preferences → Package Settings → Git → Settings，填入：
```
{ "git_binary": "/usr/local/bin/git" }
```
（路径以 which git 或 where git 输出为准）

插件装好了，但 Sublime 没识别出当前上下文是 Git 仓库——它只对「项目根目录下有 .git/」的窗口生效，不认单个文件。

错误做法：双击打开一个 index.js 文件，哪怕它属于某个仓库，插件也无上下文
正确做法：用 File → Open Folder… 打开包含 .git/ 的完整项目目录；侧边栏必须显示该目录树
验证方式：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Git: Status；如果命令灰显或根本不出现，说明还没进仓库

Git 插件只提供命令入口（提交、推送等），不负责视觉反馈；GitGutter 才是在编辑器左侧 gutter 显示 +（新增）、~（修改）、-（删除）图标的那个。

安装后图标不出现？先确认：文件路径是否在 .git/ 所在目录的子路径下；是否至少执行过一次 git add（否则全是 untracked，GitGutter 默认不标）
让新增文件也显示标记：在 Preferences → Package Settings → GitGutter → Settings – User 中加入：
```
{ "show_untracked": true }
```
性能敏感时可关实时刷新：设 "live_mode": false，只在保存或切标签页时更新 gutter

Git: Push 不是“一键同步”，它只是执行 git push；如果本地分支没设置上游（upstream），就会报错：fatal: The current branch main has no upstream branch.

必须先在终端或 Sublime 的 Git: Terminal（如有）中运行：git branch --set-upstream-to=origin/main main（把 main 和 origin/main 关联起来）
插件不处理冲突、不切换分支、不决定推到哪个远程——这些仍是 Git 命令行的事，Sublime 只是快捷触发器
推荐搭配 Sublime Merge：它专为 Git GUI 设计，能直观处理分支、合并、冲突，和 Sublime Text 右键联动顺畅

Git 最容易卡住的地方，从来不是命令记不住，而是环境没打通、上下文没对齐。PATH、.git 位置、upstream 关联——这三个点漏一个，插件就只剩个壳。