GitGutter完全没反应是因为三个硬性前提未满足：系统能调用git命令、Sublime以项目方式打开含.git的根目录、当前文件已保存；缺一即图标全无。
GitGutter 能实时显示代码改动点，但不是装完就自动工作——它依赖 Git 环境、项目结构和插件配置三者同时就位。缺一个，侧边栏就空着，连个 + 都不会出现。
为什么 GitGutter 完全没反应？三个硬性前提必须满足
插件静默 ≠ 坏了，大概率是卡在基础环境上：
- 终端里能运行
git --version，且返回有效版本号（如git version 2.40.1） - Sublime 是通过 File → Open Folder… 打开整个项目根目录，且该目录下存在
.git文件夹（不是子目录里有） - 当前编辑的文件已保存（
Ctrl+S），未保存的临时缓冲区不触发 GitGutter 检查
常见误操作：双击打开单个 .py 文件，即使它在 Git 仓库里，GitGutter 也完全不启动。
行号旁图标不显示或错位？优先排查渲染冲突
图标空白、重叠、颜色发灰，通常不是 Git 问题，而是 Sublime 的 gutter 渲染与当前主题/插件打架：
- 临时禁用所有其他 gutter 类插件（比如
BracketHighlighter、SublimeLinter），再看是否恢复 - 切换回默认主题：Preferences → Theme → Default.sublime-theme
- 检查
GitGutter.sublime-settings中的"gutter_theme"是否设为当前已安装的主题名（如"Monokai"），设错会导致图标不加载 - 别碰
gutter_size或gutter_padding—— Sublime Text 5+ 已废弃这些参数，写了也没用
修改行没标记？默认行为就是不标，得手动开开关
很多人以为“改了内容就该高亮”，但 GitGutter 默认只标新增 + 和删除 -，对内容变更的行（即行号不变、仅内容变）不做视觉提示：
- 要让修改行也显示标记（通常是橙色小点），必须在用户设置中显式启用两个选项：
-
"live_mode": true（否则只在保存后刷新） "show_gitgutter_in_modified_tabs": true- 改完设置后必须重启 Sublime —— 它只在启动时读取
git_binary和这些开关 - 注意：部分 UI 主题会弱化橙色点，建议搭配
"gutter_theme": "Default"测试效果
中文路径或空格路径报 “not a git repository”？别改编码配置
Windows 下项目路径含中文或空格，GitGutter 调用 git 时容易失败，错误信息常是 fatal: not a git repository：
- 最稳妥解法：把项目移到纯英文路径，例如
C:devmyproject - 升级 Git 到 2.30+（推荐 Git for Windows 2.40+），能大幅缓解该问题
- 手动指定
git_binary路径，用双反斜杠（Windows）或正斜杠（macOS/Linux），例如："git_binary": "C:\Program Files\Git\cmd\git.exe" - 别尝试改
env编码或 patch 插件源码——GitGutter 不暴露编码接口，改了下次更新就失效
真正容易被忽略的是：GitGutter 的“实时”其实靠每 1–2 秒轮询 git status --porcelain -z 和 git diff 实现，一旦路径解析失败，它就静默跳过，连日志都不打。所以看到空白 gutter，第一反应不该是“插件坏了”，而是“它根本没跑起来”。
