GitGutter 无反应主因是 Git 路径未配置或文件不在有效仓库内；修改后延迟显示因默认 500ms 异步轮询；图标不显系主题缺失 git_gutter scope 样式；UnicodeDecodeError 需在设置中添加 git_env 指定 UTF-8 编码。

GitGutter 插件没反应？先确认 Git 路径和仓库状态

GitGutter 不显示变更标记，90% 是因为 Sublime Text 找不到 git 命令，或当前文件不在 Git 仓库中。它不依赖 Sublime 的项目设置，只认当前文件路径是否在 .git 目录的子目录下。

实操建议：

• 终端里运行 which git（macOS/Linux）或 where git（Windows），把输出路径填进 GitGutter 设置里的 git_binary 字段；
• 用 git status 在文件所在目录手动验证是否为有效工作区；
• 如果文件是软链接或挂载路径（如 WSL 访问 Windows 文件），GitGutter 可能无法正确解析 .git 位置，建议直接在原生路径中打开项目。

为什么修改后没立刻刷新标记？看清楚“延迟更新”机制

GitGutter 默认启用异步 diff，不是实时监听文件变化，而是按固定间隔（默认 500ms）检查文件状态。这意味着快速键入时，左侧标记可能滞后半秒才出现——这不是卡顿，是设计行为。

可调整的关键配置项：

• live_mode：设为 false 可禁用自动轮询，改用手动触发（快捷键 ctrl+shift+g → Refresh）；
• debounce_delay：调小到 100 可加快响应，但会略微增加 CPU 开销；
• 注意：file_ignore_patterns 中若误加了 *.py 这类通配符，会导致对应文件完全不被检测——检查该配置是否意外屏蔽了当前类型。

标记颜色和图标不显示？检查主题与图标的兼容性

GitGutter 的标记本质是 Sublime 的 gutter 图标（gutter icon），它依赖当前 Color Scheme 是否定义了对应作用域的样式。很多第三方主题（尤其精简款）会忽略 markup.inserted.git_gutter 这类自定义 scope。

排查步骤：

• 临时切换回默认主题 Adaptive.sublime-theme，看标记是否恢复；
• 打开命令面板 → Developer: Show Scope Name，把光标停在有变更的行，确认底部显示的 scope 名是否包含 git_gutter；
• 若 scope 存在但无图标，说明主题缺失图标资源：需在主题文件中补全类似这样的块：

  {
    "class": "gutter_icon",
    "layer0.texture": "GitGutter/icons/added.png",
    "layer0.opacity": 1.0
  }

Sublime Text 4 下 GitGutter 报 UnicodeDecodeError 怎么办

这是典型编码冲突：GitGutter 调用 git diff 时，遇到文件名含中文或特殊字符（如 emoji、全角空格），而 Python subprocess 默认用系统 locale 解码 stdout，容易崩。

最稳的解法是强制指定编码：

• 编辑 GitGutter 设置，加入：

  "git_env": {
    "PYTHONIOENCODING": "utf-8",
    "LC_ALL": "C.UTF-8"
  }

• Windows 用户若仍报错，可额外加上 "git_binary": "C:\Program Files\Git\bin\git.exe"，避免调用 Windows 自带的旧版 git；
• 别碰 fallback_encoding 这类选项——它只影响文件内容读取，不解决 git 命令输出的解码问题。

插件本身不处理非 UTF-8 编码的 Git 仓库，如果你的团队还在用 GBK 提交日志，要么统一转 UTF-8，要么接受部分日志显示为 。