gitgutter只在行号右侧gutter显示git状态图标（+/-/→），不支持侧边栏高亮或染色，因sublime text原生未开放侧边栏样式api；其作用区域与侧边栏无关，混淆二者是常见误解。
GitGutter 不在侧边栏高亮，它只在行号右侧（gutter）显示状态图标；侧边栏（Side Bar）本身不支持 Git 状态染色或图标标记——这不是配置问题，是 Sublime Text 原生限制。
GitGutter 的作用区域不是侧边栏
很多人误以为“侧边栏高亮”是指文件名变色或加 badge，但 GitGutter 实际渲染位置是编辑区左侧的 gutter（行号旁空白区），显示 +、-、→ 等符号。侧边栏由 Sublime 内核直接渲染，插件无法注入样式或修改图标。
- 你看到的绿色竖线、红色减号，都在行号右边，不是文件名旁边
- 所有声称“侧边栏显示 M/A/D”的方案，要么混淆了
gutter和side bar，要么依赖已失效的 hack（如 patch 主题文件） - Sublime 官方从未开放侧边栏 DOM 或 CSS 类绑定机制，
side_bar.sublime-menu控制的是右键菜单，不是视觉样式
装完 GitGutter 没反应？先检查两个硬性前提
GitGutter 启动后无图标，大概率卡在这两个环节，而非插件本身故障。
- 系统
git命令不可达：终端运行git --version成功，但 Sublime 里报"git" is not recognized，说明 PATH 没透过去。Windows 用户重装 Git 时务必勾选 “Add Git to the system PATH”；macOS 用户建议从终端执行open -a "Sublime Text"启动，或在Preferences → Package Settings → GitGutter → Settings中手动写死"git_binary": "/opt/homebrew/bin/git" - 当前文件不在 Git 仓库内：GitGutter 只对“路径向上能找到
.git/目录”的文件生效。单个文件双击打开、或项目根目录没包含.git/，都会导致静默失效。验证方式：按Ctrl+Shift+P输入GitGutter: debug，看输出是否含repository root
图标挤成一团 / 颜色全灰？主题兼容性才是关键
GitGutter 图标渲染依赖主题对 gutter 区域的定义，不是所有主题都默认适配。
- 换回 Sublime 默认主题（
Preferences → Theme → Default.sublime-theme）测试，若恢复正常，说明你当前主题缺失gutter相关 key 或 padding 设置 - 不要手动改
gutter_padding或gutter_icons这类设置——这容易引发错位或覆盖，且不同主题的 gutter 渲染逻辑差异很大 - 主流兼容主题如
ayu、Material Theme通常自带适配；若用自定义主题，需确认其.sublime-theme文件中包含"class": "gutter"及相关 icon 定义
真正能操作 Git 的侧边栏功能，靠的是 SideBarEnhancements 提供右键菜单，而不是视觉提示；而实时状态感知，只能靠 gutter 区域。强行让图标出现在侧边栏，既无官方 API 支持，也无稳定实现路径——与其折腾不可靠的 patch，不如接受这个边界：gutter 是状态，侧边栏是导航，分工明确才少踩坑。
