gitgutter跳转命令实际跳的是git认为有差异的行，即git diff输出中出现的行（含未暂存、已暂存但未提交的变更），前提是文件已保存且属于git工作树；未保存的缓冲区内容不会被捕获。
GitGutter 跳转命令实际跳的是什么？
它跳的不是“未提交的修改处”，而是 Git 认为有差异的行——即 git diff 输出中出现的行（含未暂存、已暂存但未提交的变更），前提是文件已保存且属于 Git 工作树。未保存的缓冲区内容不会被 GitGutter 捕获，哪怕你刚敲完 10 行代码，只要没按 Ctrl+S，GitGutter Next Modification 就不会跳过去。
怎么确保 GitGutter 能识别你的修改？
常见失效场景和对应操作：
- 文件未保存 → 必须先按
Ctrl+S，否则 GitGutter 不刷新标记 - 项目根目录不含
.git→ 在终端进入文件所在目录执行git rev-parse --git-dir，若报错，需用Project → Add Folder to Project添加正确的 Git 仓库根目录（不是子文件夹） - GitGutter 设置里
live_mode关闭 → 打开Preferences → Package Settings → GitGutter → Settings，确认用户设置中有：{"live_mode": true} - Windows 上
git_binary路径含空格或中文 → 必须写成双反斜杠转义路径，例如："git_binary": "C:\Program Files\Git\cmd\git.exe"，不能用环境变量
跳转快捷键和命令绑定要点
GitGutter Next Modification 是核心命令，ID 为 git_gutter_next_modification。默认无快捷键，需手动绑定：
- 打开
Preferences → Key Bindings - 在右侧用户键位文件中添加（示例绑定到
F4）：[{"keys": ["f4"], "command": "git_gutter_next_modification"}] - 注意：该命令只对当前激活标签页生效，不跨文件；若当前文件无 Git diff，会静默失败，光标不动
- 多光标编辑时，它只跳主光标所在位置之后的第一个修改行，不考虑其他光标
为什么有时跳不到刚改的那行？
根本原因在于 GitGutter 的标记逻辑：
- 新增行（+）和删除行（-）会明确显示图标，跳转可靠
- 修改行（~）默认只加橙色小点，且部分 UI 主题会弱化颜色，容易被忽略；必须开启
show_gitgutter_in_modified_tabs才能稳定显示 - 如果该行已被
git add，GitGutter 默认不再标记——它反映的是工作区 vs 暂存区的差异，不是工作区 vs HEAD - 分支切换后标记不更新 → 需手动右键标签页选
GitGutter: Reset或重启 Sublime
真正难处理的不是跳转本身，而是判断“这行到底算不算修改”——GitGutter 完全依赖 Git 状态，和 Sublime 的编辑状态无关。你得先确认 Git 看得见它，它才跳得过去。
