GitGutter装不上或没反应，90%是环境未配齐：先确认Package Control是否正常，再搜纯名“GitGutter”安装；启用需同时满足git可用、项目根目录含.git、文件已保存三条件。
GitGutter 装不上或没反应，90% 不是插件问题，而是环境没配齐——它根本不会“自动启动”，必须同时满足三个硬性条件才能亮图标。
Package Control 失效是装不上的第一原因
别急着重装 GitGutter，先确认 Package Control 是否真在运行：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: List Packages - 如果命令不存在 → Package Control 没装；如果命令存在但列表为空/报错 → 它已失效
- 重装必须执行官方脚本后完全退出 Sublime Text（不只是关闭窗口），再重新打开——否则新脚本不生效
GitGutter 安装名只有 “GitGutter” 四个字母
在 Package Control: Install Package 搜索框里，只输 GitGutter：
- 带下划线（
Git_Gutter）、带_sublime、带数字（GitGutter4）全都不对 - 作者是
dhg，GitHub 仓库是jisaacks/GitGutter，当前唯一有效名称就是GitGutter - 装完不生效？不是安装失败，是后续条件未满足
图标不显示？检查这三个前提是否全部满足
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），它就静默失败，控制台可能有日志但界面毫无提示。
