Sublime Text 可配置为 Git 的 difftool 和 mergetool:先安装 subl 命令行工具,再执行 git config --global diff.tool sublime 与 git config --global merge.tool sublime 等命令设置 --wait、--multiinstance 等参数。

Sublime Text 可以作为 Git 的 difftool 和 mergetool 使用,关键在于配置好命令行启动方式并告诉 Git 如何调用它。下面是以 Sublime Text 4(或 3)在 macOS / Windows / Linux 下通用的配置方法,重点清晰、一步到位。
确保 Sublime 命令行工具已安装
Git 需要通过终端命令调用 Sublime,所以必须先启用 subl 命令:
- macOS:打开 Sublime → Shell Commands → Install “subl” Command(菜单栏 Tools → Command Palette → 输入 “Install Shell Command”)
-
Windows:安装时勾选 Add to PATH;或手动把
subl.exe所在目录(如C:\Program Files\Sublime Text\)加入系统环境变量 PATH -
Linux:运行
sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl(路径按实际调整)
配置完后,在终端输入 subl --help 能看到帮助信息,说明就绪。
配置 Git 使用 subl 作为 difftool
执行以下命令一次性设置全局 diff 工具(支持暂存区对比、工作区对比等):
git config --global diff.tool sublime git config --global difftool.sublime.cmd 'subl --wait "$LOCAL" "$REMOTE"' git config --global difftool.prompt false
说明:
-
--wait表示 Sublime 关闭后命令才返回,避免窗口闪退 -
"$LOCAL"和"$REMOTE"是 Git 自动传入的临时文件路径(左侧为本地版本,右侧为远端/HEAD 版本) -
prompt false禁用每次调用前的确认提示
使用方式:git difftool HEAD~1 -- file.js 或 git difftool(对比暂存区)
配置 Git 使用 subl 作为 mergetool
合并冲突时用 Sublime 编辑器打开冲突文件,需配置三路合并命令:
git config --global merge.tool sublime git config --global mergetool.sublime.cmd 'subl --wait --multiinstance "$MERGED"' git config --global mergetool.keepBackup false git config --global mergetool.keepTemporaries false
说明:
-
--multiinstance防止已有 Sublime 窗口拦截新调用(尤其 Windows/macOS GUI 下常见) -
"$MERGED"是 Git 提供的冲突合并文件路径(含 - 关闭 backup/temporary 文件可减少干扰(默认会生成 .orig 文件)
使用方式:git merge feature-branch 出现冲突后,运行 git mergetool 即启动 Sublime
(可选)让 Sublime 更适合比对/合并
提升体验的小建议:
- 安装插件 Diffy(Package Control 安装),可高亮显示行级差异
- 开启 行号 + 空格显示(View → Show Console → 输入
view.settings().set("draw_white_space", "all"))方便定位空格冲突 - 合并时手动删掉
/=======/>>>>>> branch-name及中间无用内容,保留正确逻辑后保存退出即可
基本上就这些。配置一次,后续所有仓库都生效,不用重复操作。










