git插件报“git not found”是因sublime未继承系统path，macos需终端启动，windows需确认git加入path，所有平台可手动配置git_binary路径；右键无git菜单是因未以项目目录打开；gitgutter才显示代码变更图标；推送前须设置upstream分支。
Git 插件报 “git not found” 怎么办
不是插件坏了，是 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输出为准）
右键没 Git 菜单、命令面板搜不到 Git: Status
插件装好了，但 Sublime 没识别出当前上下文是 Git 仓库——它只对「项目根目录下有 .git/」的窗口生效，不认单个文件。
- 错误做法：双击打开一个
index.js文件，哪怕它属于某个仓库，插件也无上下文 - 正确做法：用
File → Open Folder…打开包含.git/的完整项目目录；侧边栏必须显示该目录树 - 验证方式：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Git: Status；如果命令灰显或根本不出现，说明还没进仓库
想看哪几行改了？别只装 Git，得加 GitGutter
Git 插件只提供命令入口（提交、推送等），不负责视觉反馈；GitGutter 才是在编辑器左侧 gutter 显示 +（新增）、~（修改）、-（删除）图标的那个。
- 安装后图标不出现？先确认：文件路径是否在
.git/所在目录的子路径下；是否至少执行过一次git add（否则全是 untracked，GitGutter 默认不标） - 让新增文件也显示标记：在
Preferences → Package Settings → GitGutter → Settings – User中加入：{ "show_untracked": true } - 性能敏感时可关实时刷新：设
"live_mode": false，只在保存或切标签页时更新 gutter
提交后怎么推送到远程？Git 插件不自动关联分支
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 右键联动顺畅
