Sublime Text 4安装GitGutter实时显示代码修改-sublime-PHP中文网

gitgutter 搜索失败因名称错误，正确名称仅为“gitgutter”，不加下划线或_sublime后缀；安装后需手动配置绝对路径的git_binary、重启sublime、以项目方式打开含.git目录的文件夹，并启用live_mode和等宽字体。

sublime text 4安装gitgutter实时显示代码修改

GitGutter 搜不到？名字就是 GitGutter，别加下划线或_sublime

Sublime Text 4 用户搜 GitGutter_sublime 或 GitGutter4 一定失败——插件早已停更旧命名，当前唯一有效名称是 GitGutter，作者为 dhg（Drew Hays），GitHub 仓库地址是 jisaacks/GitGutter。打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 Package Control: Install Package，回车后只输 GitGutter 四个字母，确认安装即可。如果列表空白，先检查 Package Control 是否存活：输入 Package Control: List Packages，无响应则需重装 Package Control。

装完没图标？十有八九是 `git_binary` 路径配错了

GitGutter 启动时只读一次 git_binary 配置，改完不重启 Sublime 就不生效；它也不继承终端 PATH，必须手动指定 git 可执行文件的**绝对路径**：

Conventional Git

Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。

下载

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
配置位置：Preferences → Package Settings → GitGutter → Settings，在右侧用户设置中添加：
```
"git_binary": "/usr/local/bin/git"
```
（macOS 示例）
保存后必须**完全退出 Sublime（关闭所有窗口）再重新打开**，否则状态栏不会出现分支名，控制台（Ctrl+`）会持续报 GitGutter: git not found

图标显示异常或颜色错乱？先关主题、换等宽字体

GitGutter 的侧边栏标记依赖 Unicode 块元素（如 ▌、▐）和主题对 git_gutter scope 的样式支持。常见问题不是插件坏了，而是渲染环境不匹配：

图标挤成方块、错位、全灰？临时切回默认主题：Preferences → Theme → Adaptive.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_gutter 等字样

修改了代码但图标不更新？检查文件是否已暂存 + 是否启用 `live_mode`

GitGutter 默认只标记**已暂存（staged）或已跟踪（tracked）文件的变更**，且对未保存的修改（dirty buffer）默认延迟响应：

新增/删除的文件必须先执行 git add 或 git rm，否则只显示绿色竖线（untracked），不显示修改/删除标记
未保存时图标不刷新？在 GitGutter 设置中加：
```
"live_mode": true
```
，它会让插件每 500ms 主动调用 git diff —— 小项目没问题，但大仓库或网络盘上容易卡顿，可改用
```
"debounce_delay": 100
```
加速，或干脆设为 false 改用手动刷新（快捷键 Ctrl+Shift+G → Refresh）
file_ignore_patterns 若误写成 "*.py"，整个 Python 文件都会被跳过检测，务必检查该配置项是否意外屏蔽了当前类型