gitgutter仍可用但仅支持sublime text 4（build 4126+）及python 3.8+，不兼容st3；安装需通过package control搜索“gitgutter”精确名称，且必须满足git可用、项目根目录含.git、文件已保存三条件才生效。
GitGutter 是目前 Sublime Text 上唯一稳定、轻量、且仍在维护的版本控制提示插件，能实时显示新增（+）、修改（~）、删除（-）行标记。但它不是装上就亮，必须同时满足三个硬性条件，缺一不可。
GitGutter 安装名只有 “GitGutter” 四个字母
Package Control 搜索时，只输 GitGutter：带下划线（Git_Gutter）、带 _sublime 后缀、带数字（GitGutter4）全都不对。作者是 dhg，GitHub 仓库是 jisaacks/GitGutter，当前唯一有效名称就是 GitGutter。
如果搜不到，先确认 Package Control 是否正常：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: List Packages。命令不存在 → Package Control 没装；命令存在但列表为空/报错 → 它已失效，需重装官方脚本并**完全退出 Sublime Text**（不只是关窗口）再重启。
图标不显示？检查这三项是否全部满足
GitGutter 不会为单个文件启动，它只认「项目根目录 + .git + 已保存文件」这个组合：
-
git --version在终端必须返回版本号（如git version 2.40.1） - Sublime 必须通过
File → Open Folder…打开整个项目目录，且该目录下直接包含.git/文件夹（不是子目录里有） - 当前编辑的文件必须已保存过（
Ctrl+S），未保存的缓冲区不会触发 diff
双击打开单个 .py 文件，哪怕路径在 Git 仓库里，GitGutter 也完全静默。
图标错位、全灰、悬停无弹窗？主题/字体/配置三处易漏
侧边栏渲染异常，大概率不是插件 bug，而是环境不匹配：
- 临时切回默认主题：
Preferences → Theme → Default.sublime-theme，若恢复说明当前主题缺失git_gutterscope支持 - 字体必须等宽：在
Preferences → Settings中加入"font_face": "Fira Code"（macOS/Linux）或"font_face": "Consolas"（Windows） -
git_binary必须设绝对路径，且改完要**完全退出 Sublime 再重启**——它只在启动时读一次配置 -
live_mode默认关闭，需手动设为true并重启才支持实时更新（不保存也能看到差异）
最常被忽略的一点：GitGutter 的所有行为都依赖 Git 进程输出。一旦 git status 在终端报错（比如中文路径未设 core.quotepath=false），它就静默失败，控制台可能有日志但界面毫无提示。
真正关键的不是“怎么装”，而是“它什么时候才开始工作”——只要 .git 目录不在你打开的文件夹里，或者 git 命令压根没被 Sublime 看见，图标就不会出现，无论你重装多少次。
