sublime如何安装并使用GitGutter_sublime实时显示代码改动标记【教程】-sublime-PHP中文网

GitGutter需满足三个前提才能正常工作：1. 正确配置git_binary路径；2. 通过Package Control安装官方GitGutter插件；3. 文件必须位于已初始化且含.git目录的有效Git仓库内。

sublime如何安装并使用gitgutter_sublime实时显示代码改动标记【教程】

GitGutter 能在 Sublime Text 编辑器侧边栏实时显示 Git 差异标记（如新增、修改、删除行），但它的安装和启用依赖几个关键前提，缺一不可。

确认已安装 Git 命令行并可被 Sublime 调用

GitGutter 本质是调用系统 git 命令比对工作区与暂存区/HEAD 的差异。如果 Sublime 找不到 git，插件会静默失效，不报错也不显示标记。

在终端运行 which git（macOS/Linux）或 where git（Windows），确认返回有效路径，例如 /usr/local/bin/git 或 C:\Program Files\Git\cmd\git.exe
Sublime 默认可能无法读取 shell 的 PATH（尤其 macOS GUI 启动时）。需在 Sublime 中打开 Preferences → Settings – User，添加：
```
"git_binary": "/usr/local/bin/git"
```
（路径按你本地实际替换）
重启 Sublime，再打开一个 Git 仓库内的文件测试

通过 Package Control 安装 GitGutter_sublime 插件

官方插件名为 GitGutter，不是 GitGutter_sublime——后者是旧版或非官方分支，容易导致兼容性问题或功能缺失。

确保已安装 Package Control（没装请先按 Ctrl+Shift+P / Cmd+Shift+P 输入 Install Package Control 安装）
调出命令面板（Ctrl+Shift+P），输入 Package Control: Install Package 回车
搜索 GitGutter，选择并安装（图标为绿色 Git 分支符号）
安装后无需手动启用，只要文件属于 Git 仓库且 git_binary 配置正确，标记会自动出现

检查项目是否处于有效 Git 仓库中

GitGutter 只对「已初始化的 Git 仓库内」且「有 .git 目录」的文件生效。常见失效场景：

github-repo-analyzer

当用户提及 GitHub URL，或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时，请使用此技能。触发条件包括以下短语：“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”，或消息中包含任何 github.com URL。

下载

文件路径不在 .git 目录所在树下（比如用 Sublime 打开了子目录外的单个文件）
仓库刚 git init 但尚未 git add 任何文件 —— 此时所有改动都算“未跟踪”，GitGutter 默认不显示未跟踪文件的新增标记（可通过设置 "show_untracked": true 开启）
使用了 git worktree 或子模块，而 Sublime 打开的是子模块路径但未识别为独立仓库（需确保子模块内有完整 .git 文件或目录）

自定义显示行为与调试技巧

默认样式可能被主题覆盖或标记过密，可通过用户配置微调：

打开 Preferences → Package Settings → GitGutter → Settings – User

常用配置项示例：

{
  "live_mode": true,
  "show_markers_on_untracked_file": true,
  "enable_git_commit_mode": false,
  "untracked_color": "yellow",
  "modified_color": "cyan"
}