GitGutter需满足三个前提才能正常工作：1. 正确配置git_binary路径；2. 通过Package Control安装官方GitGutter插件；3. 文件必须位于已初始化且含.git目录的有效Git仓库内。
GitGutter 能在 Sublime Text 编辑器侧边栏实时显示 Git 差异标记（如新增、修改、删除行），但它的安装和启用依赖几个关键前提，缺一不可。
确认已安装 Git 命令行并可被 Sublime 调用
GitGutter 本质是调用系统 git 命令比对工作区与暂存区/HEAD 的差异。如果 Sublime 找不到 git，插件会静默失效，不报错也不显示标记。
- 在终端运行
which git（macOS/Linux）或where git（Windows），确认返回有效路径，例如/usr/local/bin/git或C:\Program Files\Git\cmd\git.exe - Sublime 默认可能无法读取 shell 的 PATH（尤其 macOS GUI 启动时）。需在 Sublime 中打开
Preferences → Settings – User，添加："git_binary": "/usr/local/bin/git"
（路径按你本地实际替换） - 重启 Sublime，再打开一个 Git 仓库内的文件测试
通过 Package Control 安装 GitGutter_sublime 插件
官方插件名为 GitGutter，不是 GitGutter_sublime——后者是旧版或非官方分支，容易导致兼容性问题或功能缺失。
- 确保已安装
Package Control（没装请先按Ctrl+Shift+P/Cmd+Shift+P输入Install Package Control安装） - 调出命令面板（
Ctrl+Shift+P），输入Package Control: Install Package回车 - 搜索
GitGutter，选择并安装（图标为绿色 Git 分支符号） - 安装后无需手动启用，只要文件属于 Git 仓库且
git_binary配置正确，标记会自动出现
检查项目是否处于有效 Git 仓库中
GitGutter 只对「已初始化的 Git 仓库内」且「有 .git 目录」的文件生效。常见失效场景：
- 文件路径不在
.git目录所在树下（比如用 Sublime 打开了子目录外的单个文件） - 仓库刚
git init但尚未git add任何文件 —— 此时所有改动都算“未跟踪”，GitGutter 默认不显示未跟踪文件的新增标记（可通过设置"show_untracked": true开启） - 使用了
git worktree或子模块，而 Sublime 打开的是子模块路径但未识别为独立仓库（需确保子模块内有完整.git文件或目录）
自定义显示行为与调试技巧
默认样式可能被主题覆盖或标记过密，可通过用户配置微调：
- 打开
Preferences → Package Settings → GitGutter → Settings – User - 常用配置项示例：
{ "live_mode": true, "show_markers_on_untracked_file": true, "enable_git_commit_mode": false, "untracked_color": "yellow", "modified_color": "cyan" } - 若仍无标记，打开 Sublime 控制台（
Ctrl+`），查看是否有类似GitGutter: git command not found或GitGutter: not a git repository的提示 - 临时禁用其他 Git 类插件（如
SideBarGit），避免冲突
最容易被忽略的是：GitGutter 不刷新“已暂存”的修改 —— 它只对比工作区与暂存区（index）。如果你刚 git add 了某文件，那它左侧就不再显示修改标记，这是设计使然，不是插件坏了。
