sublime Text 4.4+ 可通过 gitGutter 插件启用侧边栏分支显示,只需在用户设置中添加 “show_branch_name_in_sidebar”: true 即可在文件夹旁实时显示当前 Git 分支名(如 main、feature/auth),配合兼容主题(如 default、Ayu)即可生效,无需修改主题文件或编写 css。

sublime text 默认不显示 Git 分支状态,但可通过插件 + 主题微调实现侧边栏(Side Bar)文件/文件夹旁显示当前 Git 分支(如 main、feature/login)或修改状态(● 修改 / ✅ 已暂存)。关键不是“主题配置”本身,而是插件驱动 + 主题样式适配。
安装 GitGutter 或 SideBarEnhancements(推荐 GitGutter)
GitGutter 是最轻量、专注 Git 状态的插件,支持在侧边栏图标旁叠加分支名和文件变更标记:
- 通过 Package Control 安装 GitGutter(搜索即可)
- 安装后默认启用,无需额外配置即可显示行号旁的 Git 变更图标(● △ ✅)
- 要显示分支名,需开启
show_branch_name_in_sidebar选项(Sublime Text 4.4+ 原生支持)
启用侧边栏分支显示(Sublime Text 4.4+)
打开 Preferences → Package Settings → GitGutter → Settings,在右侧用户设置中添加:
{ "show_branch_name_in_sidebar": true, "branch_name_position": "right" // 可选:left / right(默认 right) }
保存后,侧边栏每个文件夹(工作区根目录)右侧会显示当前 Git 分支名,例如:src/ main 或 project/ feature/auth
主题兼容性与视觉微调
分支文字默认使用小号灰色字体,若当前主题(如 Material Theme、Ayu)隐藏了侧边栏次要文字,可能看不见。可手动增强显示:
- 打开 Preferences → Browse Packages…,进入
User/目录 - 新建文件
GitGutter.sublime-settings(或编辑已有),确保上述设置生效 - 如需加粗或改色,需自定义
side_bar.sublime-menu(高级),但通常不建议——GitGutter 的分支标签是 overlay 图层,依赖主题对sidebar_label的支持 - 推荐换用兼容性好的主题,如 Default、Adaptive 或 ayu(开启
"ui_font_size_small": true后更清晰)
替代方案:SideBarEnhancements + Git 插件(适合老版本)
若用 Sublime Text 3 或 GitGutter 不生效,可用组合方式:
- 安装 SideBarEnhancements(增强右键菜单和图标)
- 再安装 Git 官方插件(由 wbond 维护,提供
git: branch命令) - 通过命令面板(
Ctrl+Shift+P)运行Git: Branch查看当前分支(非实时显示在侧边栏) - 真正实现实时侧边栏分支标识,仍强烈建议升级到 ST4 + GitGutter
基本上就这些。核心是 GitGutter + 开启 show_branch_name_in_sidebar,主题只需不屏蔽 sidebar 小字即可。不需要改 .tmTheme 文件或写自定义 CSS。