gitGutter插件需搜“GitGutter”（无下划线及_sublime后缀），安装后若状态栏无分支名，需手动配置git_binary路径；未保存文件默认不显示差异，可启用live_mode；图标异常多因字体非等宽，应设为Consolas或Fira Code。
GitGutter 插件装不上，Package Control 搜索不到怎么办
不是插件下架了，而是名字变了——新版本叫 GitGutter，旧版带 _sublime 后缀的已停更。sublime text 4 用户如果搜 GitGutter_sublime，根本不会命中任何结果。
- 打开 Package Control（
Ctrl+Shift+P/Cmd+Shift+P），输入Install Package，回车后搜GitGutter（注意：没有下划线，没有_sublime） - 确认安装的是作者为
dhg（Drew Hays）的仓库，github 主页是https://github.com/jisaacks/GitGutter - 装完别急着重启，先检查 Sublime 底部状态栏是否出现 Git 分支名；没出现，说明 Git 可执行文件路径没被识别到
装完 GitGutter 没反应，状态栏不显示分支、图标也不变色
核心原因：Sublime 找不到系统里的 git 命令。它不读 shell 的 PATH，也不自动继承终端环境变量，得手动配。
- 打开
Preferences → Package Settings → GitGutter → Settings，在右侧用户设置里加一行："git_binary": "/usr/bin/git"（macos/linux）或"git_binary": "C:Program FilesGitbingit.exe"（windows） - 路径必须是
git可执行文件本身，不是git.cmd或git-bash.exe；不确定路径？终端里运行which git（macOS/Linux）或where git（Windows） - 改完保存，不用重启 Sublime，插件会自动重载；如果仍不生效，按
Ctrl+`调出控制台，看有没有GitGutter: git not found类报错
为什么改了代码，GitGutter 的左右侧边栏图标没更新
默认情况下 GitGutter 只监听已保存文件的 Git 状态。未保存的修改（dirty buffer）不会触发差异计算——这是设计行为，不是 bug。
- 想实时响应未保存改动？在 GitGutter 设置里加上：
"live_mode": true - 但要注意：
live_mode会频繁调用git diff，对大仓库或慢磁盘（比如网络挂载目录）可能卡顿；小项目开它没问题，大项目建议关掉 - 另一个常见干扰：文件没加到 Git 索引里（
git status显示 untracked）。GitGutter 对 untracked 文件只显示“新增”图标（绿色竖条），不显示修改/删除标记
Windows 上 GitGutter 图标错位或显示方块，字体渲染异常
本质是 Sublime 默认用了不支持等宽符号的字体，而 GitGutter 依赖 Unicode 块元素（如 ▌、▐）画侧边栏标记。
- 进
Preferences → Settings，在用户设置里加："font_face": "Consolas"（Windows 推荐）或"font_face": "Fira Code"（需提前安装） - 别用
Segoe ui或microsoft YaHei这类非等宽字体，它们不保证符号对齐，图标会偏移甚至叠在一起 - 如果用了字体连字（ligatures），某些连字引擎会把 GitGutter 的符号当成可连字字符处理，导致显示异常；可在设置中加
"font_options": ["no_ligatures"]关掉
GitGutter 的坑基本都绕着三件事打转：名字拼写、git 路径、字体渲染。尤其 Windows 用户容易卡在前两个环节，反复重装不如花半分钟查清 git 在哪、再填进设置里。