gitgutter 状态栏不显示分支名是因为它本身不提供该功能，需单独安装 gitstatus 插件；同时需正确配置 git_binary 路径、确保 sublime 以项目根目录打开（含 .git 文件夹）、使用等宽字体并禁用连字。
GitGutter 状态栏不显示分支名，根本不是插件没装好
它压根不依赖“插件是否启用”，而是卡在 Git 可执行文件路径没配对。Sublime 启动时只读一次 git_binary 配置，改完设置不重启 Sublime，状态栏永远空白。
常见错误现象：GitGutter: git not found 出现在控制台（Ctrl+`），或状态栏右下角完全没反应。
- 先在终端运行
which git（macOS/Linux）或where git（Windows），拿到真实路径 - 打开
Preferences → Package Settings → GitGutter → Settings – User - 填入绝对路径，例如：
"git_binary": "/usr/local/bin/git"或"git_binary": "C:\Program Files\Git\bin\git.exe" - 保存后必须**完全退出 Sublime（不只是关闭窗口）再重开**，否则配置不加载
打开的不是 Git 仓库根目录，GitGutter 就当它不存在
Sublime 不会递归扫描子目录找 .git，它只认当前“项目根目录”下有没有 .git/ 文件夹。双击打开单个 .js 文件？哪怕它物理上属于某个仓库，GitGutter 也无上下文。
- 务必用
File → Open Folder…打开包含.git/的完整项目目录 - 侧边栏应显示该目录树，而不是一堆零散文件标签页
- 验证方式：终端进该目录，运行
git status要有输出；再在 Sublime 中按Ctrl+Shift+P输入GitGutter: Diff，如果命令灰显或报错，说明还没进仓库
图标能显示但分支名不出现？可能你装错了插件
GitGutter 本身只负责 gutter 左侧的 +/~/- 标记，**不提供状态栏分支显示功能**。很多人混淆了它和 GitStatus 或 GitSavvy。
- 想在状态栏右下角直接看到
branch: main，请单独安装GitStatus（搜这个名字，别搜 GitGutter） -
GitStatus安装后无需额外配置，只要项目是合法 Git 仓库，状态栏自动出分支名 - 若仍不显示，检查
git rev-parse --is-inside-work-tree是否返回true；返回false说明 Sublime 当前上下文根本不在 Git 工作区里
字体和主题导致图标错位或变方块，跟 Git 没半点关系
GitGutter 用 Unicode 块元素（如 ▌、▐）画 gutter 图标，非等宽字体无法对齐，结果就是空白、重叠、或一堆豆腐块。
- 进
Preferences → Settings，确认"font_face"设为等宽字体，例如："font_face": "Fira Code"或"font_face": "Consolas" - 禁用字体连字：
"font_options": ["no_ligatures"]，避免符号被连写逻辑干扰 - 换回 Sublime 默认主题（
Preferences → Theme → Default.sublime-theme）测试——如果恢复正常，就是你当前主题没适配gutter渲染区域
git add 的新文件、未 git rm 的删除文件，默认就不标。这不是 bug，是它严格遵循 Git 三棵树模型的结果。别指望它替你做 git status 的事。
