GitGutter插件可在Sublime Text行号旁实时显示Git修改状态：绿色圆点为新增、黄色/橙色波浪线为修改、红色减号为删除；安装需满足三个前提——已装Package Control、系统已装Git且可执行、Sublime以项目文件夹方式打开（含.git目录）；装完即生效，无需重启。
Sublime Text 本身不显示 Git 修改痕迹，但装上 GitGutter 插件后，就能在行号旁（gutter）实时看到每行的增删改状态——绿色圆点是新增，黄色/橙色波浪线是修改，红色减号是删除。
怎么装 GitGutter 并让它立刻生效
安装本身很简单，但“装完就用”有三个硬性前提，缺一不可：
- 已安装
Package Control（没装的话，按Ctrl+`调出控制台，粘贴官网最新安装代码） - 系统已安装 Git，且终端能运行
git --version（否则插件根本找不到 Git） - Sublime 是以**整个项目文件夹**方式打开的（即菜单栏显示的是项目路径），且该目录下存在
.git文件夹
满足以上后，按 Ctrl+Shift+P → 输入 Package Control: Install Package → 搜索并安装 GitGutter，无需重启编辑器，打开任意受 Git 跟踪的文件就会自动显示标记。
图标不显示？先检查这四件事
常见现象：装了插件，但 gutter 里空空如也。不是插件坏了，大概率是环境没对齐：
- 当前文件未被 Git 跟踪（比如新建的
temp.py还没git add）→ 执行git add .后保存文件再看 - Sublime 打开的是单个文件，不是项目根目录 → 关掉，用
File → Open Folder...重新打开含.git的文件夹 - Git 可执行文件路径没被识别（尤其 Windows 安装 Git 时没勾选 “Add to PATH”）→ 在
Preferences → Package Settings → GitGutter → Settings中手动指定：{ "git_binary": "C:\Program Files\Git\bin\git.exe" } - 插件被意外禁用或配置关闭了实时模式 → 检查设置里是否有
"git_gutter_live_mode": false，删掉或设为true
怎么快速对比当前修改和 HEAD
光看图标只能知道“哪行动了”，要确认“改成啥样了”，得调出差异（diff）：
- 鼠标悬停在带标记的行上 → 自动弹出高亮 diff 浮层（支持语法着色，看清字符级变化）
- 按
Ctrl+Shift+P→ 输入GitGutter: Compare with HEAD→ 查看整个文件与最新提交的全部差异 - 想手动刷新 gutter 状态（比如刚
git stash了但图标没变）→ 运行GitGutter: Diff
注意：Compare with HEAD 依赖 Git 工作区干净（无未暂存更改），否则可能只比对到暂存区，结果不准。
侧边栏（sidebar）也能显示 Git 状态？需要额外搭配
GitGutter 默认只管编辑区 gutter，**不负责侧边栏文件图标**。如果希望在左侧文件列表里看到 M（修改）、A（新增）等标记，必须加装另一个插件：
- 安装
A File Icon（同样通过 Package Control）→ 它会自动读取 Git 状态，在文件名前加小图标（如蓝色箭头表示 modified） - 确保 Sublime 是以项目方式打开、且
.git存在 → 否则 A File Icon 不会触发 Git 检测 - 不推荐单独用
AYGIT：它只提供命令面板里的文本列表，无法在侧边栏实时渲染图标
真正容易被忽略的一点：所有 Git 插件都依赖 Sublime 正确识别项目上下文。哪怕 GitGutter 设置全对，只要你是双击打开一个孤立的 .py 文件，而不是通过 Open Folder 加载整个仓库，gutter 就永远是空的。
