GitGutter 安装需搜纯名“GitGutter”，配对正确 git_binary 路径并重启 Sublime，启用等宽字体及 live_mode，且仅标记已暂存变更；新增/删除文件须先 git add/git rm 才显示图标。
GitGutter 安装失败？大概率是搜错了名字
Sublime Text 4 用户搜 GitGutter_sublime 或带下划线的旧名，根本找不到插件——它已停更，新版本就叫 GitGutter，作者是 dhg（Drew Hays），GitHub 仓库是 jisaacks/GitGutter。
- 打开命令面板：
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入
Package Control: Install Package回车 - **只搜
GitGutter** —— 不加下划线、不加_sublime、不加版本号 - 确认安装后，插件会自动启用，无需重启 Sublime
如果搜不到，检查 Package Control 是否正常：按 Ctrl+Shift+P 后输 Package Control，看是否有响应；若无，需先重装 Package Control。
装完没反应？八成是 Git 路径没配对
GitGutter 启动时只读一次 git_binary 配置，改完不重启就无效；而且它不会帮你初始化仓库，只监听已有 .git 目录的变更。
- 确保项目根目录下有
.git文件夹（不是子目录里） - 在 Sublime 中用
File → Open Folder…打开整个项目文件夹，而非单个文件 - 按
Ctrl+Shift+P输入Preferences: Package Settings → GitGutter → Settings - 在用户设置中添加：
"git_binary": "/usr/local/bin/git"
（macOS）、"git_binary": "C:\Program Files\Git\bin\git.exe"
（Windows）或你系统中where git/which git返回的真实路径 - 保存后必须 完全退出并重启 Sublime，否则配置不加载
重启后看状态栏右下角是否出现分支名（如 main）；没有就说明 git_binary 还是错的，可按 Ctrl+` 打开控制台，找 GitGutter: git not found 报错。
图标不显示或乱码？字体惹的祸
GitGutter 依赖 Unicode 块元素（如 ▌、▐）画 gutter 标记，非等宽字体无法正确渲染，导致空白、方块或错位。
- 进
Preferences → Settings，确认"font_face"设为等宽字体，例如："font_face": "Fira Code"
或"font_face": "Consolas"
- 别用系统默认的“微软雅黑”“苹方”这类比例字体
- 如果用了字体连字（ligatures），建议关掉：
"font_options": ["no_ligatures"]
，避免干扰符号解析 - 未保存的修改（dirty buffer）默认不显示标记——这是设计行为，不是 bug；如需实时响应，启用：
"live_mode": true
图标颜色可自定义，但改的是 color_scheme 文件里的作用域，不是 GitGutter 设置本身；比如想让新增行变蓝，得在主题里加：
"scope": "markup.inserted.git_gutter", "foreground": "#4285F4"
为什么新增/删除文件没图标？Git 状态层级搞错了
GitGutter 默认只比对工作区与暂存区（index），未 git add 的新文件、未 git rm 的已删文件，都不算“已知变更”，自然不标。
- 新建文件后执行
git add .再保存，才会出+标记 - 删了文件但没
git rm，GitGutter 不感知——得靠AYGIT: Show Status或命令行git status辅助识别 - 忽略文件（
.gitignore中的）不会显示任何标记，侧边栏还会自动褪色 - 如果同时装了
BracketHighlighter或SublimeLinter，可能抢占 gutter 区域；临时禁用它们，确认是否冲突
真正容易被忽略的是：GitGutter 每 1–2 秒静默执行 git status --porcelain -z 和 git diff --cached -z，所以它永远看不到“未暂存的修改”对暂存区的影响——想对比 HEAD，得先 git add，否则弹窗里显示的只是暂存内容。
