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。

GitHub Push 自动推送

使用自动 SSH 和远程配置实现安全的 GitHub 推送自动化。适用于执行 `git push`、自动化推送或处理冲突等场景。

下载

• 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、vs origin/main、vs 任意 commit 或分支
  • 逐块（hunk）暂存/丢弃，双击跳转到 Sublime 对应行
  • 合并冲突时的三路视图（LOCAL / BASE / REMOTE）
• 首次使用需在 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 负责兜底通用比对——混用反而容易搞不清哪条线在报错。