Git插件在Sublime中报“Git not found”是因GUI未继承shell的PATH；需终端启动（macOS）或检查PATH配置（Windows），或手动设置git_binary路径。
Git 命令在终端能用，但 Sublime 里报 Git not found
这是最常见、也最容易卡住人的第一步。Sublime 的 Git 插件（比如 wbond 维护的 Git）不自带 Git，它只是调用你系统 PATH 里的 git 可执行文件。如果终端里 git --version 正常，但 Sublime 报错，大概率是 GUI 环境没继承 shell 的 PATH。
- macOS 用户：用终端启动 Sublime，比如
open -a "Sublime Text"或直接运行/Applications/Sublime\ Text.app/Contents/MacOS/Sublime\ Text；否则 GUI 启动时 PATH 往往只有/usr/bin，找不到 Homebrew 装的 git - 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
插件装好了 ≠ 功能就可用。Git 插件只对「当前文件所属的 Git 仓库根目录下」生效——也就是说，你得打开整个项目文件夹（含 .git/ 目录），而不是只打开某个单文件。
- 错误做法：双击一个
index.js文件单独打开，即使它属于某仓库，插件也识别不了上下文 - 正确做法：用
File → Open Folder…打开包含.git/的项目根目录；或者确保当前 Sublime 窗口的侧边栏显示的是该仓库的完整路径树 - 验证方式：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Git: Status，如果命令灰显或不出现，说明 Sublime 没检测到仓库环境
想看代码改了哪几行？别装 Git，要装 GitGutter
Git 插件只提供命令入口（提交、推送等），不负责视觉反馈。GitGutter 才是在编辑器左侧 gutter 显示 +（新增）、~（修改）、-（删除）图标的那个插件——但它同样依赖系统 git，且默认不标记“未跟踪”文件。
- 安装后图标不出现？先检查：当前文件是否在
.git目录的子路径下；是否已git add过至少一个文件（否则全是 untracked，GitGutter默认不渲染） - 想让新增文件也标出来：在
Preferences → Package Settings → GitGutter → Settings – User中加入：{ "show_untracked": true } - 性能敏感时可关实时刷新：
{ "live_mode": false }，这样只在保存或切换标签页时更新 gutter，适合大文件或老旧机器
想一键推送到远程？Git: Push 不会替你设 upstream
很多人点完 Git: Commit 就顺手点 Git: Push，结果弹出错误：fatal: The current branch main has no upstream branch。这不是插件 bug，而是 Git 本身要求你明确告诉它“推到哪个远程分支”。
- 必须先在终端或 Sublime 内嵌终端（如装了
Terminus）里执行一次：git branch --set-upstream-to=origin/main main（把main换成你本地分支名） - 或者用更通用的方式：
git push -u origin main，-u 参数就是设置 upstream - 之后
Git: Push才能成功；否则插件只会原样转发命令，不会自动补参数或猜意图
真正麻烦的不是装插件，而是 Git 本身的状态管理逻辑全得你自己理清楚：当前在哪个分支、有没有关联远程、哪些文件已暂存、有没有冲突……Sublime 插件只是把命令按钮化了，它不替你做决定，也不掩盖底层复杂性。
