gitgutter图标实际显示在行号区（gutter）右侧，而非侧边栏；需同时满足git命令可调用、文件位于git工作树内、插件正确加载三条件，缺一不可。
Sublime Text 侧边栏本身不显示 Git 状态，GitGutter 的图标实际出现在行号区（gutter）右侧，不是侧边栏；所谓“侧边栏显示 Git 差异”是常见误解。你要的其实是行号旁的 +/−/~ 标记，它依赖 Git 可执行文件、项目在 Git 工作树内、插件正确加载这三者同时成立。
GitGutter 安装后没图标？先确认 git 是否被识别
GitGutter 不自带 Git，它靠系统 PATH 中的 git 命令获取状态。如果行号旁空空如也，第一步不是调设置，而是验证终端能否跑通：
- Windows：打开命令提示符，运行
where git或git --version；若报“不是内部或外部命令”，说明 Git 没进 PATH —— 把C:\Program Files\Git\bin\git.exe加进系统环境变量，或在 GitGutter 用户设置里硬编码路径 - macOS / Linux：从 Dock 启动 Sublime 时，它可能不继承 shell 的 PATH（尤其用 Homebrew 安装 Git 的用户），建议在
Preferences → Package Settings → GitGutter → Settings的用户配置中显式写死：{ "git_binary": "/opt/homebrew/bin/git" } - 别信“自动检测”，它在非标准环境大概率静默失败；控制台（
Ctrl+`）里一旦出现Git not found或subprocess.CalledProcessError，基本就是这个原因
图标只对当前文件生效，不认 Sublime 项目结构
GitGutter 按文件路径向上查找第一个 .git 目录，和你是否用 Project → Save Project As… 无关。典型失效场景：
抓取指定 GitHub用户的 Stars 项目，生成标准化中文 Markdown 报告。用户提及「分析 GitHub stars」「导出收藏项目」「汇总 GitHub 星标」「生成 stars 报告」或粘贴含 ?tab=stars 的链接时触发。执行通过 bash...
- 你把
/src/components/Button.js单独拖进 Sublime，但.git在/根目录下 —— 插件不会跨多级父目录搜索，它只查/src/components/.git、/src/.git、/.git这种路径顺序，中途断掉就放弃 - 在终端进入该文件所在目录，运行
git rev-parse --git-dir；若输出fatal: not a git repository，那图标必然不出现，和插件版本、设置全无关系 - 临时测试：在当前目录下执行
git init，只要生成了.git，图标立刻出现（哪怕没 commit）
行号旁图标 vs 侧边栏：别被名字带偏
“SidebarGit” 是另一个插件，但它在 Sublime Text 4 上已不可用；而 “GitGutter” 的 gutter 指的是编辑器左侧的行号区域（line number gutter），不是文件浏览器那个侧边栏（side bar）。Sublime 原生不提供 API 让插件修改侧边栏文件图标的颜色或加 badge，所有声称“侧边栏 Git 状态”的方案，要么是误称，要么是极不稳定的手动 hack。
如果你真需要侧边栏操作，搭配 SideBarEnhancements：它不改图标，但在右键菜单注入 Git → Stage、Revert 等选项，和 GitGutter 完全不冲突。
最常被忽略的一点：GitGutter 默认不为未跟踪（untracked）文件显示标记，除非你在设置里打开 "show_markers_on_untracked_file": true；另外，某些 UI 主题会覆盖 gutter 渲染区域，换回默认主题（Adaptive）能快速排除干扰。
