GitGutter没反应需先确认文件是否在正确Git仓库内，检查.git目录存在、路径匹配、配置支持非标准结构；再排查设置中live_mode和show_markers_on_untracked是否启用，最后校验color_scheme与gutter_theme兼容性及插件冲突。

GitGutter插件没反应？先确认Git仓库和路径是否正确

GitGutter不会自动生效，它依赖本地 Git 仓库的 .git 目录存在，且 Sublime Text 打开的文件必须在该仓库工作区路径内。常见错误是：用 Sublime 直接双击打开单个文件（如 /Users/me/project/file.py），但该文件不在 Git 仓库根目录下——此时 GitGutter 不会显示任何标记。

• 确保用 subl .（终端进入仓库根目录后执行）或通过 Sublime 的 File → Open Folder… 打开整个仓库目录
• 检查当前文件是否属于 Git 管理：git ls-files --error-unmatch <current-file-path> 应返回文件名，否则 GitGutter 视为“未跟踪”
• 如果项目使用了 core.worktree 或裸仓库等非标准结构，GitGutter 默认不支持，需手动配置 git_binary 和 git_root

行内修改标记不出现？检查 GitGutter 设置和 Git 状态

即使在正确仓库中，GitGutter 也可能不显示 +/−/! 标记，最常见原因是 Git 暂存区（index）与工作区状态未被及时捕获，或插件设置禁用了实时刷新。

• 默认只监控“已暂存”和“未暂存”变更；若刚改完文件但没运行 git add，只会显示未暂存的修改（右侧边栏小圆点），而行内标记（如左侧的 +、-）需开启 show_markers_on_untracked 和 live_mode
• 确认用户设置中启用了关键项：

  {
    "live_mode": true,
    "show_markers_on_untracked": true,
    "enable_git_commit_menu": false
  }

• 某些 Git 配置（如 core.autocrlf 在 Windows 上触发换行符差异）会导致 Git 认为“有修改”，但 GitGutter 可能因 diff 超时或编码问题跳过渲染——可临时设 "diff_options": ["--no-color", "-U0"] 简化比对

标记颜色或位置异常？调整 color_scheme 和 gutter_theme

GitGutter 的行内标记（+−!）本质是 Sublime 的 gutter 图标，其显示效果受两个独立配置影响：主题色板（color_scheme）决定图标颜色，gutter theme（gutter_theme）决定图标样式和尺寸。两者不匹配时会出现透明、错位或消失。

Git Changelog Generator

使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……

下载

• 推荐搭配使用官方维护的配套主题，例如安装 GitGutter-Default 主题后，在用户设置中显式指定：

  "gutter_theme": "GitGutter-Default"

• 若自定义了 color_scheme（如 Monokai.sublime-color-scheme），需确认其中定义了 gutterForeground 和 gutter 区域，否则标记可能不可见
• Mac 上 Retina 屏幕有时会模糊图标，可尝试将 gutter_theme 改为 GitGutter-2x（需额外下载高清资源包）

与其它插件冲突（如 SideBarEnhancements 或 Git）？优先级和命令覆盖要厘清

GitGutter 提供的右键菜单项（如 Git: Stage Hunk）和快捷键（如 ctrl+shift+h）可能被其他 Git 插件劫持或忽略，尤其当多个插件监听同一事件（如 on_post_save_async）时。

• 禁用或卸载重复功能插件：SideBarEnhancements 自带 Git 集成，若同时启用会干扰 GitGutter 的状态刷新逻辑
• 检查快捷键冲突：用 Preferences → Key Bindings 搜索 git_gutter，确认绑定未被覆盖；例如默认的 ctrl+shift+h（hunk stage）易与中文输入法冲突，建议改为 ctrl+alt+h
• 部分 LSP 插件（如 sublimelsp）在大型文件中延迟触发 on_modified，导致 GitGutter 标记滞后；可调大 debounce_delay（单位 ms）避免频繁重绘

GitGutter 的核心价值在轻量、低侵入地反馈 Git 状态，但它不替代 git status 或 IDE 级别的变更管理——一旦发现标记行为不符合预期，优先查 Git 工作区状态，再查插件配置层级，最后才怀疑插件本身。