Sublime Text 中实现 Git 差异对比需组合使用 Git 插件（执行 git diff）、GitGutter（边栏实时标记）和 Sublime Merge（图形化交互），FileDiffs 则用于通用文本比对。
Git 插件本身不叫 GitDiff，Sublime Text 中没有独立名为 “GitDiff” 的官方插件——你真正需要的是 Git（由 wbond 维护）或 GitGutter + Sublime Merge 组合，它们共同构成快速、可靠、免跳转的本地与 Git 版本对比方案。
怎么让 Sublime 直接看到当前文件和 HEAD 的差异？
最轻量、最常用的方式是用 Git 插件调用内置 git diff。前提是：Git 已安装且路径配置正确（Windows 常见坑：没加进系统 PATH，或 Sublime 没读到）。
- 确认 Git 可用：终端执行
git --version能返回版本号 - 在 Sublime 中按
Ctrl+Shift+P→ 输入Git: Diff→ 回车 - 结果会以新标签页打开，显示类似
git diff HEAD -- path/to/file.py的高亮输出，新增/删除/修改行均有颜色标记 - 如果报错
Unable to find git binary，需手动配置：Preferences → Package Settings → Git → Settings – User，填入：{ "git_command": "C:\\Program Files\\Git\\bin\\git.exe" }（macOS/Linux 改为/usr/bin/git或which git输出路径）
为什么装了 Git 插件却看不到边栏差异标记？
因为 Git 插件只提供命令行集成，不自动渲染 gutter 图标。要实现“一眼看出哪几行改了”，必须额外安装 GitGutter。
-
GitGutter是独立插件，需通过 Package Control 单独安装 - 安装后无需配置即可工作：只要文件在 Git 仓库内，左侧 gutter 就会实时出现图标：
-
+（蓝色）→ 新增行 -
~（橙色波浪线）→ 修改行 -
-（红色）→ 删除行（仅标记删除前的位置）
-
- 注意：它只对比 工作区内容 vs 索引（staged）或 HEAD，不会反映未
git add的暂存区状态差异 - 若 gutter 无反应，检查文件是否被
.gitignore忽略，或项目根目录下没有.git文件夹
想图形化对比、支持暂存块、跨分支比对怎么办？
这时候别硬扛，直接用 Sublime Merge——它是 Sublime 官方出品的 Git GUI，和 Sublime Text 共享底层逻辑，无缝联动。
- 安装后，在 Sublime 中右键文件 →
Open in Sublime Merge，或按Ctrl+Shift+P→Git: Open in Sublime Merge - 它能清晰展示：
- 当前文件 vs
HEAD、vsorigin/main、vs 任意 commit 或分支 - 逐块（hunk）暂存/丢弃，双击跳转到 Sublime 对应行
- 合并冲突时的三路视图（LOCAL / BASE / REMOTE）
- 当前文件 vs
- 首次使用需在
Sublime Merge → Preferences → Locations中指定项目路径，否则可能找不到仓库 - 不建议用它替代命令行做重操作（如 rebase），但看 diff、选块提交、查 blame，它比任何插件都稳
FileDiffs 插件适合什么场景？和 Git 插件有什么区别？
FileDiffs 不依赖 Git，它干的是「任意两个文本之间的差异」，比如：当前文件 vs 剪贴板、vs 另一个未纳入版本控制的 .bak 文件、vs 临时生成的 JSON 输出——它不是 Git 工具，而是通用文本比对工具。
- 典型用法：
- 选中一段代码 →
Ctrl+Shift+P→FileDiffs: Compare with Clipboard - 打开两个文件 → 分屏布局 → 右键任一 tab →
FileDiffs: Compare Current File with Other File
- 选中一段代码 →
- 它不能告诉你“这行是不是 Git 里删掉的”，只能告诉你“这两段文本哪里不一样”
- 如果想对接 Git，得手动配外部命令，例如在
FileDiffs.sublime-settings里写：{ "cmd": ["git", "diff", "--no-color", "--no-index", "$file1", "$file2"] }但这不如直接用Git: Diff直观
Git 配置和差异感知的关键不在插件数量，而在分清职责：Git 负责命令调度，GitGutter 负责实时视觉反馈，Sublime Merge 负责深度交互，FileDiffs 负责兜底通用比对——混用反而容易搞不清哪条线在报错。
