Sublime Text 侧边栏原生不支持 Git 状态图标，因无 API 允许插件修改其颜色、样式或添加 badge；GitGutter 图标实际位于行号区（gutter）右侧，非侧边栏；SidebarGit 在 ST4 已失效；稳定方案是 GitGutter（行内标记）+ SideBarEnhancements（右键 Git 操作）+ GitSavvy（状态面板）。
Sublime Text 侧边栏本身无法显示 Git 状态图标——这不是配置问题，而是 Sublime 原生不提供 API 让插件修改侧边栏文件图标的颜色、样式或添加 badge。所有声称“在侧边栏显示 Git 图标”的方案，要么混淆了 gutter（行号区）和 side bar（侧边栏），要么依赖已失效或极不稳定的 hack。
GitGutter 的图标根本不在侧边栏，而在行号区右侧
很多人装完 GitGutter 发现“侧边栏没反应”，其实是看错了位置：GitGutter 的 +/−/~ 标记默认渲染在编辑器左侧的 gutter（即行号显示区域的右侧空白处），不是文件浏览器那个侧边栏。它和 SideBarEnhancements 或 Aygit 完全无关，也不影响侧边栏 UI。
-
gutter是 Sublime 的编辑区组件，支持插件注入图标；side bar是纯文件系统视图，无公开渲染接口 - 如果你在行号旁看到绿色竖线、蓝色修改标记、红色删除线，说明
GitGutter已正常工作 - 所谓“侧边栏 Git 图标”在 ST4 中不存在稳定实现，
SidebarGit插件已在 Sublime Text 4 上彻底失效（Python 3.8+ 兼容性断裂 + API 变更）
想让侧边栏有 Git 视觉提示？只有间接方案
你无法让文件名旁自动出现 M、A 或彩色圆点，但可通过组合插件获得近似效果：
Git Changelog Generator
下载
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
- 安装
SideBarEnhancements：它不改图标，但在侧边栏右键菜单中注入Git子菜单（Stage、Revert、Diff等），操作路径清晰 - 搭配
Aygit或GitSavvy：运行Aygit: Show Status或GitSavvy: status，弹出带颜色编码的变更文件列表（M=modified、A=added），支持回车跳转 - 启用
highlight_modified_tabs（设置里加"highlight_modified_tabs": true）：未保存的修改会高亮 tab 标签，虽非 Git 状态，但能辅助识别脏文件 - 别碰
A File Icon的 Git 集成：它只在命令面板输出文本列表，不能驱动侧边栏实时染色，且依赖.git在项目根目录，容错率低
GitGutter 不显示图标？90% 是这三件事没做对
图标消失不是主题或设置问题，而是基础链路断了。先验证这三项，再调配置：
- 终端里运行
git --version必须成功返回版本号；若失败，GitGutter必定静默失效（Windows 用户常漏勾安装时的 “Add Git to PATH”） - 当前文件路径必须能向上找到
.git目录；在该文件所在目录执行git rev-parse --git-dir，有输出才有效（单独拖一个src/components/Button.js进来，但.git在/根目录，它找不到） -
GitGutter用户设置中必须显式指定git_binary路径；macOS/Homebrew 用户尤其注意：GUI 启动的 Sublime 不继承 shell 的PATH，得写死为"/opt/homebrew/bin/git"或"/usr/local/bin/git"
别浪费时间折腾“侧边栏 Git 图标”
真正容易被忽略的是：Sublime 的侧边栏设计上就拒绝这类扩展。任何试图 patch side_bar.sublime-menu、重写渲染逻辑、或 hook 文件节点 DOM 的尝试，都会在下次升级后崩掉。ST4 的插件生态已明确转向“分工协作”——GitGutter 负责行内差异，SideBarEnhancements 负责右键操作，GitSavvy 负责状态面板。把精力放在确保这三者各司其职，比强行染色侧边栏靠谱得多。
