GitSavvy 是 Sublime Text 中稳定显示 Git 分支的可靠插件,启用 git_savvy_status_bar_view 后状态栏自动显示分支名;若失效需检查仓库路径、权限及是否通过 GitSavvy 切换分支,支持手动刷新或轮询,亦可借助 GitSavvy-Enhanced-Status 补丁显示分支与 commit short hash。

Sublime Text 默认不显示 Git 分支,但通过插件可以稳定实现状态栏实时显示当前 Git 分支名——关键在于选对插件、正确配置,并避开常见路径权限和仓库识别问题。
用 GitGutter + SublimeGit 还是 GitSavvy?
GitGutter 只标出代码变更(如修改/新增行),不显示分支;SublimeGit 已停止维护且不兼容 Sublime Text 4;真正可靠的是 GitSavvy ——它原生支持状态栏分支显示,且持续更新。
- 安装后启用
git_savvy_status_bar_view功能即可自动在状态栏右下角显示branch: main或branch: feature/login - 无需额外配置,默认监听文件保存和焦点切换事件,响应及时
- 若状态栏无反应,先检查当前文件是否在 Git 仓库内:
git rev-parse --is-inside-work-tree返回true才有效
状态栏显示分支但总是 stale(过时)?
常见原因是 GitSavvy 没有监听到 Git 命令行操作(比如你在终端切了分支,Sublime 不知道)。它只感知编辑器内触发的 Git 行为或文件系统变更事件。
- 手动刷新:按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入GitSavvy: refresh status回车 - 开启自动轮询(不推荐高频使用):在
Preferences → Package Settings → GitSavvy → Settings中添加:{ "git_savvy.status_bar_polling_interval": 3000 }(单位毫秒,设太小会增加磁盘 I/O) - 更稳妥的做法:所有分支切换尽量通过 GitSavvy 命令完成(如
GitSavvy: checkout branch),避免终端与编辑器状态脱节
想同时显示分支 + 当前 commit short hash?
GitSavvy 默认只显示分支名,但可通过自定义状态栏内容实现。注意:这不是开箱即用功能,需改写视图事件监听逻辑。
- 打开
Preferences → Package Settings → GitSavvy → Key Bindings,添加快捷键绑定执行自定义命令 - 更直接的方式:安装社区补丁插件
GitSavvy-Enhanced-Status(非官方,需从 GitHub 手动下载 .sublime-package) - 该补丁会将状态栏文字改为类似
branch: dev | 3a1b2c,其中3a1b2c是git rev-parse --short HEAD结果 - 注意兼容性:仅适配 GitSavvy v2.30+ 和 Sublime Text 4 build 4126+
状态栏 Git 信息依赖两个底层条件:当前文件属于某个 Git 仓库的已跟踪路径,且该仓库的 .git 目录可被 Sublime 正常读取(尤其在符号链接目录或 WSL 路径下容易失败)。如果分支名始终为空,优先用终端进入文件所在目录运行 git status 确认 Git 环境本身是否正常。










