// 文档

集成

git difftool 与 mergetool、文件管理器右键菜单、Subversion、Mercurial、Perforce,以及编辑器。

这些都在「偏好设置 › 集成」里配置,也能从那里撤销:每一项都会先说明它要写什么,点「配置」才写, 并记下足够的信息把它再拿掉。

Git

[diff]
    tool = geecompare
[difftool "geecompare"]
    cmd = geecompare --wait --readonly "$LOCAL" "$REMOTE"

[merge]
    tool = geecompare
[mergetool "geecompare"]
    cmd = geecompare --wait "$LOCAL" "$REMOTE" "$BASE" -o "$MERGED"
    trustExitCode = true

写进全局配置还是当前仓库,由你选。--wait 是让 git 等窗口关闭的那个开关;trustExitCode 让合并的 退出码告诉 git 冲突是否已经解决。配好之后,git difftool 和 git mergetool 就会打开 GeeCompare, 三方合并打开时基准版本和输出文件都已经就位。

文件管理器

右键一个文件或文件夹就能比。各平台的菜单项是一样的:比较选中的两项、「选为左侧」,然后在第二项上 「与〈刚才选的〉比较」。打开开关时按当前用户注册,关掉时注销。

  • macOS:一个 Finder 扩展,签过名,装在应用里。
  • Windows:资源管理器处理程序(gc_shell.dll),按当前用户注册。Windows 11 的一级菜单需要 签名包,没有签名时菜单项在「显示更多选项」里。
  • Linux:Nautilus、Dolphin、Thunar。

其它版本控制

下面每一项都会写自己的配置;某些工具的参数顺序对不上,就再写一个小包装脚本(放在 GeeCompare 的 数据目录里):

工具 写什么
Subversion ~/.subversion/config 的 [helpers] diff-cmd 和 merge-tool-cmd,指向包装脚本
Mercurial ~/.hgrc(Windows 上是 mercurial.ini):extdiff、merge-tools 和 ui.merge
Perforce $P4ENVIRO(默认 ~/.p4enviro)里的 P4DIFF 和 P4MERGE,经包装脚本调用
Plastic SCM、TFS 只提供模板:它们的配置没有公开文档,或者写在 Visual Studio 自己的注册表里

编辑器

编辑器 怎么配
JetBrains IDE 设置 › 工具 › 差异与合并 › 外部工具:程序路径,参数 --wait %1 %2 --lefttitle=%3 --righttitle=%4
VS Code settings.json:外部比较工具,以及 geecompare 的路径

命令

「安装 geecompare 命令」把 geecompare 装到 PATH 上(macOS 和 Linux 上是一个小启动器, Windows 上由安装程序把程序目录加进去)。装好之后,命令行页上的东西在任何终端里 都能用,上面那些编辑器也可以直接写命令名。

外部比较与合并工具

GeeCompare 也能把文件交给别的程序:命令行能匹配上这个文件的工具会出现在会话的 ☰ 菜单里, 参数替换还是那一套 %1、%2、%3、%4,分别是左、右、基准和输出。合并工具的退出码决定这个会话 算不算已解决,所以 git mergetool --tool=geecompare 可以把一个二进制冲突直接转交给懂这个格式的程序。

最后更新:2026-11-22