sublime的Side Bar侧边栏如何显示Git分支状态? (主题配置)

3次阅读

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

sublime的Side Bar侧边栏如何显示Git分支状态? (主题配置)

sublime text 默认不显示 Git 分支状态,但可通过插件 + 主题微调实现侧边栏(Side Bar)文件/文件夹旁显示当前 Git 分支(如 mainfeature/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/ mainproject/ feature/auth

sublime的Side Bar侧边栏如何显示Git分支状态? (主题配置)

神笔马良

神笔马良 – AI让剧本一键成片。

sublime的Side Bar侧边栏如何显示Git分支状态? (主题配置) 320

查看详情 sublime的Side Bar侧边栏如何显示Git分支状态? (主题配置)

主题兼容性与视觉微调

分支文字默认使用小号灰色字体,若当前主题(如 Material Theme、Ayu)隐藏了侧边栏次要文字,可能看不见。可手动增强显示:

  • 打开 Preferences → Browse Packages…,进入 User/ 目录
  • 新建文件 GitGutter.sublime-settings(或编辑已有),确保上述设置生效
  • 如需加粗或改色,需自定义 side_bar.sublime-menu(高级),但通常不建议——GitGutter 的分支标签是 overlay 图层,依赖主题对 sidebar_label 的支持
  • 推荐换用兼容性好的主题,如 DefaultAdaptiveayu(开启 "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。

text=ZqhQzanResources