Sublime Text 本身不支持 Git,必须通过 GitSavvy 插件实现完整协作流程;常见失效原因有三:装错插件、git_path 配置错误、未以含 .git 的文件夹形式打开项目。

Sublime Text 本身不支持 Git 版本管理,必须通过 GitSavvy 插件实现完整协作流程;装错插件、路径没配对、项目没以文件夹形式打开,这三件事占了 90% 的“Git 不生效”问题。
GitSavvy 安装后命令面板搜不到 git: status?先查这三件事
不是插件没装好,是上下文没激活。GitSavvy 只在满足全部条件时才加载命令:
- 系统终端能跑
git --version(验证 Git CLI 真实可用) - Sublime 是以包含
.git/目录的**文件夹**方式打开项目(不是单个文件,也不是子目录) - 命令面板里输入
GitSavvy: Status或git: status能触发——如果灰显或报No git repository found,说明前两项至少有一项失败
git_path 配置写错路径或用错字段名,就会一直卡 loading
GitSavvy 默认不读系统 PATH,尤其 macOS GUI 启动、Windows PATH 注册异常时必崩。手动填路径是对的,但字段名和格式极易出错:
- 配置入口:Preferences → Package Settings → GitSavvy → Settings(注意是
GitSavvy,不是Git) - 必须用
"git_path"字段(不是"git_binary"或"git_command"),且值为对象而非字符串 - Windows 示例:
"git_path": {"windows": "C:\Program Files\Git\bin\git.exe"}(双反斜杠) - macOS 示例:
"git_path": {"osx": "/opt/homebrew/bin/git"}(Homebrew 安装路径,不是 /usr/bin/git) - 改完保存,**必须重启 Sublime Text**,否则设置不生效
执行 git: push 报错 “fatal: The current branch … has no upstream branch”?别急着敲命令行
这是首次推送 feature 分支的正常现象,GitSavvy 提供了交互式解法,比手输 git push --set-upstream 更安全:
- 确保已在目标分支(如
feature/login-ui)上,且已提交过至少一次 - 按
Ctrl+Shift+P输入git: push→ 选Push current branch - 若弹出提示说 no upstream,直接回车确认 —— GitSavvy 会自动补上
--set-upstream origin <branch></branch> - 如果之前误操作导致远程分支名和本地不一致,先用
git: checkout branch切到develop,再git: pull拉最新,最后切回本地分支重试
rebase onto develop 时 commit 消失?你可能跳过了状态检查
GitSavvy 的 git: rebase 是直调 git rebase,不会帮你防错。常见误操作是:没确认当前分支干净、没先拉 develop、或 rebase 过程中没处理冲突就强行继续。
- 执行前务必运行
git: status:工作区和暂存区都应显示 “clean”,否则先git: add+git: commit - 切到
develop执行git: pull,确保本地develop和远程一致 - 切回 feature 分支,
git: rebase→Rebase current branch onto→ 输入develop - 若中途停在 conflict,用
git: resolve conflict打开冲突文件,编辑后保存 → 回到状态面板按c继续(不是再按git: commit)
最易被忽略的一点:GitSavvy 不会自动刷新日志视图。rebase 完成后,要手动按 l 打开 log 面板,再按 r refresh,才能看到新顺序的 commit 列表。


















