GitGutter装不上首要排查Package Control是否正常：按Ctrl+Shift+P输入“Package Control: List Packages”，若命令不存在则未安装，存在但报错或无响应则可能失效；需重装官方Python脚本并重启。
GitGutter装不上？先确认Package Control是否真在工作
绝大多数“安装失败”根本不是GitGutter的问题，而是Package Control压根没装好或已失效。Sublime Text本身不带包管理器，所有插件都依赖它——跳过这步，后面全白忙。
验证方法：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: List Packages。如果命令不存在，说明Package Control没装；如果存在但报错、卡住、或列表为空，大概率是网络超时或缓存损坏。
- 重装
Package Control：去官网复制对应 Sublime 版本的 Python 安装代码，粘贴进 Sublime 的控制台（Ctrl+`）执行 - 国内用户常因 GitHub 资源加载慢失败，别反复点“Install Package”，可临时改
hosts或等网络通畅再试 - 装完务必重启 Sublime，再打开命令面板确认
Package Control: Install Package可用
装完没图标？检查git路径和仓库状态
GitGutter不是“装完就亮”，它有两个硬性前提：系统能找到git命令，且当前文件在 Git 仓库内（或其子目录）。缺一不可。
常见现象：插件装好了，但行号旁没+/−/▶图标，状态栏也不显示分支名。
- 终端运行
which git（macOS/Linux）或where git（Windows），确认git路径 - 在 Sublime 中打开
Preferences → Package Settings → GitGutter → Settings，把"git_binary"设为绝对路径，例如"/usr/local/bin/git"或"C:\Program Files\Git\bin\git.exe" - 确保当前文件属于某个 Git 仓库：终端进该目录，执行
git status应有输出；如果文件在未git init的文件夹里，GitGutter 就不会工作 - Sublime 默认只监控当前视图（tab）所在文件的仓库；用
Project → Add Folder to Project加多个根目录时，每个文件夹需各自含.git/，否则只认第一个
图标挤成一团或颜色全灰？先换回默认主题验证
GitGutter 的图标渲染依赖 Sublime 主题对 gutter 区域的支持，不是所有主题都适配它的样式规则。
典型表现：图标位置错乱、颜色发灰、甚至完全看不见，但控制台又没报错。
- 先切换到 Sublime 默认主题：
Preferences → Theme → Default.sublime-theme，看是否恢复正常 - 如果恢复了，说明你当前主题没定义
gutter相关 key，比如gutterForeground或guttericon mapping - 不要手动改
gutter_padding或gutter_icons等设置来“强行对齐”，这容易引发渲染异常或覆盖主题逻辑
想改 +/− 行颜色？得动配色方案，不是改插件设置
GitGutter 显示的插入、删除、修改行高亮颜色，不由插件配置控制，而是由当前配色方案（.sublime-color-scheme）中 markup.inserted.diff 等 scope 决定。
常见错误：去搜 comment 或 string scope 改颜色，完全不相关。
- 打开
Preferences → Customize Color Scheme（自动创建并打开Packages/User/Custom.sublime-color-scheme） - 在
"rules"数组里添加如下规则（颜色值必须是十六进制，如"#4ec9b0"）：{ "scope":"markup.inserted.diff", "foreground":"#4ec9b0" },<br>{ "scope":"markup.deleted.diff", "foreground":"#f44747" },<br>{ "scope":"markup.changed.diff", "foreground":"#c586c0" } - 改完保存，立刻生效；若没变化，用
Ctrl+Shift+P → Developer: Show Scope Name把光标放在带+的行上，确认真实 scope 名是否拼对
最容易被忽略的点：即使配色改对了，如果文件没被 Git 跟踪（git status 显示 untracked），或者插件设置里 "enable": false，依然看不到任何差异标记——功能开关和仓库上下文，比颜色设置优先级高得多。
