搜不到 gitgutter？唯一有效名称是gitgutter，作者dhg，github仓库jisaacks/gitgutter；需通过package control安装，只输“gitgutter”四字，不加下划线或版本号；若失败，先确认package control是否正常，再检查git_binary绝对路径并重启sublime。
搜不到 GitGutter？名字就是 GitGutter，别加下划线或版本后缀
Package Control 里搜 GitGutter_sublime、GitGutter4 或 git-gutter 全部失败——当前唯一有效插件名是 GitGutter，作者为 dhg（Drew Hays），GitHub 仓库是 jisaacks/GitGutter。打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 Package Control: Install Package，回车后**只输 GitGutter 四个字母**，选中安装即可。如果列表空白，先运行 Package Control: List Packages 确认 Package Control 是否存活；无响应就得重装。
装完没图标？十有八九是 git_binary 路径配错了
GitGutter 启动时只读一次 git_binary 配置，改完不重启 Sublime 就不生效；它也不继承终端 PATH，必须手动填绝对路径：
- macOS/Linux：终端运行
which git，结果如/opt/homebrew/bin/git或/usr/local/bin/git，复制进设置 - Windows：命令行运行
where git，取git.exe路径（不是git.cmd或git-bash.exe），常见为C:\Program Files\Git\bin\git.exe或C:\Program Files\Git\cmd\git.exe
配置位置：菜单 → Preferences → Package Settings → GitGutter → Settings，在右侧用户设置中添加："git_binary": "/usr/local/bin/git"（macOS 示例）。保存后**必须完全退出 Sublime（关闭所有窗口），再重新打开**，否则状态栏不会出现分支名，控制台（Ctrl+`）会持续报 GitGutter: git not found。
图标挤成方块、错位、全灰？先关主题、换等宽字体
GitGutter 的侧边栏标记依赖 Unicode 块元素（如 ▌、▐）和主题对 git_gutterscope 的样式支持。不是插件坏了，而是渲染环境不匹配：
- 图标变方块、错位、颜色发灰？临时切回默认主题：
Preferences → Theme → Adaptive.sublime-theme或Default.sublime-theme，恢复即说明当前主题缺失 gutter 图标定义 - 行号旁图标消失但控制台无报错？检查字体是否等宽：
Preferences → Settings中加"font_face": "Fira Code"（macOS/Linux）或"font_face": "Consolas"（Windows） - 想确认 scope 是否被识别？光标停在修改行，按
Ctrl+Alt+Shift+P（Win/Linux）或Cmd+Alt+Shift+P（macOS）调出Developer: Show Scope Name，底部应含markup.inserted.git_g
改了内容没标记？默认不标“修改行”，得手动开开关
很多人以为“改了内容就该高亮”，但 GitGutter 默认只标新增 + 和删除 -，对内容变更的行（行号不变、仅内容变）不做视觉提示：
- 要让修改行也显示标记（通常是橙色小点），必须在用户设置中显式启用两个选项：
"live_mode": true（否则只在保存后刷新），"show_gitgutter_in_modified_tabs": true - 改完设置后必须重启 Sublime —— 它只在启动时读取
git_binary和这些开关 - 部分 UI 主题会弱化橙色点，建议搭配
"gutter_theme": "Default"测试效果
真正容易被忽略的是：GitGutter 不监控暂存区变化，它只比对工作区与 HEAD；所以 git add 后再改，标记也不会更新——除非你再保存文件或触发 live_mode 的监听。
