GitGutter需满足三条件才工作：文件属有效Git仓库、已保存、Sublime以项目目录方式打开；未满足则无+/-/|/!标记；修改行高亮需启用live_mode和show_gitgutter_in_modified_tabs；图标异常多因color_scheme缺gutter配置或gutter_theme不匹配。
GitGutter 能显示行级 Git 状态，但不是装完就自动工作——它只在文件属于有效 Git 仓库、已保存、且 Sublime 是以项目目录方式打开的前提下才触发标记。
GitGutter 没图标？先确认这三件事
行号旁没出现 +、|、- 或 !，大概率卡在这三个硬性条件上：
- 系统终端能执行
git --version；如果报 command not found，Sublime 就找不到 Git，得重装 Git 或修正git_binary路径 - Sublime 必须通过
subl .（终端进仓库根目录后执行）或 File → Open Folder… 打开整个项目目录，而不是双击单个文件——否则插件压根不启动 diff 检测 - 当前文件必须已保存（.py/.js 等有真实路径），未保存的临时缓冲区不会被 GitGutter 监控
验证是否在 Git 工作树内：终端进入该文件所在目录，运行 git rev-parse --git-dir；返回 .git 表示正确，报错就得往上翻父目录找 .git 文件夹。
修改行没高亮？live_mode 和 show_gitgutter_in_modified_tabs 得开
默认情况下，GitGutter 只对新增/删除行显示图标（+ 和 -），而内容修改（同一行文字变）仅靠右侧 gutter 小圆点提示，不加竖线。要让修改行也带视觉标记，必须手动启用两个设置：
-
"live_mode": true：开启实时监听，文件一改就刷新标记（有轻微性能开销） -
"show_gitgutter_in_modified_tabs": true：允许在“已修改但未保存”的 tab 上渲染变更标记
这两个都得写进 Preferences → Package Settings → GitGutter → Settings — User 里，改完必须完全退出 Sublime 再重启，否则不生效。注意：|（绿色竖线）只表示“暂存区 vs 工作区差异”，如果你刚改完还没 git add，它可能仍不显示——这是 GitGutter 的设计逻辑，不是 bug。
颜色不对、图标消失或模糊？别调主题，先查 gutter_theme 和 color_scheme 兼容性
GitGutter 的图标本质是 Sublime 的 gutter 图标，它的可见性取决于两个独立配置是否匹配：
-
color_scheme文件（如Monokai.sublime-color-scheme）里必须定义了gutterForeground和gutter区域，否则图标会透明或不可见 -
gutter_theme（如GitGutter-2x）决定图标尺寸和样式；Mac Retina 屏用普通 theme 会模糊，得换高清版
常见症状：图标颜色极淡、位置偏移、只显示一半——八成是 color_scheme 缺少 gutter 配置，或 gutter_theme 和当前 UI 主题冲突。别急着换主题，先打开 Preferences → Color Scheme 看当前方案名，再查它是否包含 gutter 支持。
最常被忽略的其实是“未保存”这个状态：哪怕你改了十行，只要没按 Ctrl+S，GitGutter 就当它不存在。另外，!（空白变更）标记默认开启，但部分旧版或自定义 color_scheme 会弱化它的黄色，看起来像没反应——这不是配置错，是主题把感叹号颜色压得太低了。
