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+ 的安全策略变（截至 2026 年 5 月 19 日）。首次推送必须显式指定远程分支。
- 先在终端执行：
git push -u origin main（把main换成你当前分支名） - 之后再用
Git: Push就能直接推送，不用再加参数 - 如果当前分支名不是
main，先查分支：git branch --show-current，再用对应名字替换
最易被忽略的是：插件不维护状态缓存、不监听文件系统、不自动重绘 UI 元素。比如 Git: Stash 后状态栏仍显示 main*，这是正常行为；想刷新，得手动执行 Git: Status 或切换标签页。
