Sublime Text 本身不带 Git，配置本质是让插件调用系统 git 命令并确保在含 .git 的项目根目录下运行；90% 失败源于路径未配对或目录未正确打开。
Sublime Text 本身不带 Git，所谓“配置 Git”，本质是让插件能调用你系统里已装好的 git 命令，并确保它在正确的项目上下文中运行。90% 的失败都卡在这两点：路径没配对、目录没打开对。
Git 命令报 “git is not recognized” 怎么修
这不是插件坏了，是 Sublime 找不到你的 git 可执行文件。终端里 git --version 能跑，不代表 Sublime 继承了同一套 PATH。
- macOS：GUI 启动（双击图标）时
PATH默认只有/usr/bin，Homebrew 安装的git在/opt/homebrew/bin/git就被忽略 —— 解决方式二选一：
– 终端运行open -a "Sublime Text"
– 或手动配置：Preferences → Package Settings → Git → Settings – User，填入：{"git_command": "/opt/homebrew/bin/git"} - Windows：重装 Git for Windows，务必勾选 Add Git to the system PATH；已装错就先运行
where git看输出路径，再填进上面的git_command配置里 - Linux：桌面启动常丢
$PATH，建议终端执行subl .；或改sublime-text.desktop的Exec=行为：Exec=env PATH=$PATH subl %F
右键没 Git 菜单、命令面板搜不到 Git: Status
插件只在「当前窗口根路径下存在 .git/ 目录」时才激活。它不认单个文件，也不认子目录。
- 错误做法：双击打开一个
index.js文件，哪怕它属于某个仓库，插件也无上下文 - 正确做法：用
File → Open Folder…打开包含.git/的完整项目目录；侧边栏顶部必须显示该路径（如/Users/me/project） - 验证方式：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Git: Status；如果命令灰显或根本不出现，说明还没进仓库
怎么让左边行号旁显示 + ~ − 标记
Git 插件本身不提供视觉标记，那是 GitGutter 的事。装完 Git 插件后，你还得单独装 GitGutter 并做基础配置。
- 安装
GitGutter：通过Package Control: Install Package搜索并安装，作者是jisaacstone - 默认不标未跟踪文件（
untracked），想让新增文件也显示标记，需在Preferences → Package Settings → GitGutter → Settings – User中加入：{"show_untracked": true} - 性能敏感时可关实时刷新：
"live_mode": false，只在保存或切换标签页时更新 gutter
Git: Push 报 “no upstream branch” 怎么办
这不是 Sublime 的 bug，而是 Git 2.0+ 的安全策略变化：git push 默认拒绝首次推送，除非明确设置了 push.default。
- 必须在终端或 Git Bash 中运行：
git config --global push.default matching - 别用
current或upstream，它们在 Sublime 插件里兼容性不稳定 - 该配置写入的是全局
~/.gitconfig，和 Sublime 无关，但 Sublime 会读取它 - 首次推送前，还得手动设置上游分支：
git push -u origin main（或master），否则Git: Push仍会静默失败
最易被忽略的一点：所有配置都依赖「你当前打开的是含 .git/ 的项目根目录」这个前提。路径不对，其他全白搭；而路径问题又最难被意识到——因为 Sublime 不报错，只是安静地不干活。
