Sublime Text安装并使用GitGutter显示代码差异-sublime-PHP中文网

gitgutter装不上首要排查package control是否正常：按ctrl+shift+p输入“package control: list packages”，若命令不存在则未安装，存在但报错或无响应则可能失效；需重装官方python脚本并重启。

sublime text安装并使用gitgutter显示代码差异

GitGutter装不上？先确认Package Control是否真在工作

绝大多数“安装失败”根本不是GitGutter的问题，而是Package Control压根没装好或已失效。Sublime Text本身不带包管理器，所有插件都依赖它——跳过这步，后面全白忙。

验证方法：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: List Packages。如果命令不存在，说明Package Control没装；如果存在但报错、卡住、或列表为空，大概率是网络超时或缓存损坏。

重装Package Control：去官网复制对应 Sublime 版本的 Python 安装代码，粘贴进 Sublime 的控制台（Ctrl+`）执行
国内用户常因 GitHub 资源加载慢失败，别反复点“Install Package”，可临时改hosts或等网络通畅再试
装完务必重启 Sublime，再打开命令面板确认 Package Control: Install Package 可用

装完没图标？检查git路径和仓库状态

GitGutter不是“装完就亮”，它有两个硬性前提：系统能找到git命令，且当前文件在 Git 仓库内（或其子目录）。缺一不可。

常见现象：插件装好了，但行号旁没+/−/▶图标，状态栏也不显示分支名。

终端运行 which git（macOS/Linux）或 where git（Windows），确认git路径
在 Sublime 中打开 Preferences → Package Settings → GitGutter → Settings，把 "git_binary" 设为绝对路径，例如 "/usr/local/bin/git" 或 "C:\Program Files\Git\bin\git.exe"
确保当前文件属于某个 Git 仓库：终端进该目录，执行 git status 应有输出；如果文件在未 git init 的文件夹里，GitGutter 就不会工作
Sublime 默认只监控当前视图（tab）所在文件的仓库；用 Project → Add Folder to Project 加多个根目录时，每个文件夹需各自含 .git/，否则只认第一个

图标挤成一团或颜色全灰？先换回默认主题验证

GitGutter 的图标渲染依赖 Sublime 主题对 gutter 区域的支持，不是所有主题都适配它的样式规则。

Git Factory

为每个编码任务配置并管理独立的 Git worktree，支持并行分支和清晰的 PR 工作流，避免合并冲突。

下载

典型表现：图标位置错乱、颜色发灰、甚至完全看不见，但控制台又没报错。

先切换到 Sublime 默认主题：Preferences → Theme → Default.sublime-theme，看是否恢复正常
如果恢复了，说明你当前主题没定义 gutter 相关 key，比如 gutterForeground 或 gutter icon mapping
不要手动改 gutter_padding 或 gutter_icons 等设置来“强行对齐”，这容易引发渲染异常或覆盖主题逻辑

想改 +/− 行颜色？得动配色方案，不是改插件设置

GitGutter 显示的插入、删除、修改行高亮颜色，不由插件配置控制，而是由当前配色方案（.sublime-color-scheme）中 markup.inserted.diff 等 scope 决定。

常见错误：去搜 comment 或 string scope 改颜色，完全不相关。

打开 Preferences → Customize Color Scheme（自动创建并打开 Packages/User/Custom.sublime-color-scheme）

在 "rules" 数组里添加如下规则（颜色值必须是十六进制，如 "#4ec9b0"）：

{ "scope":"markup.inserted.diff", "foreground":"#4ec9b0" },<br>{ "scope":"markup.deleted.diff", "foreground":"#f44747" },<br>{ "scope":"markup.changed.diff", "foreground":"#c586c0" }