命令是 geecompare。在「偏好设置 › 集成」里点「安装 geecompare 命令」把它装到 PATH 上;
macOS 和 Linux 上装的是一个小启动器,Windows 上由安装程序把程序目录加进 PATH。
打开一个比较
geecompare <a> <b> # 比较两个文件或文件夹
geecompare <a> <b> <base> -o <out> # 三方合并,结果写到 out
不写 --fv 时,会话类型由两侧的内容决定。下面这些开关都是带窗口用的:
| 开关 | 作用 |
|---|---|
--wait |
窗口关闭后才返回(git difftool 需要它) |
--readonly |
两侧都以只读打开 |
--lefttitle=、--righttitle= |
用这些标题代替路径显示 |
--fv=<类型> |
指定会话类型:text、folder、table、hex、picture、textmerge、foldermerge、sync |
--session=<名字> |
按名字打开保存过的会话 |
不开窗口
| 开关 | 作用 |
|---|---|
--quick[=rules|binary|crc|size|timestamp] |
只比较并返回退出码,不输出内容。--qc 是同一个开关 |
--report=<设置> <a> <b> <out> |
用保存好的报告设置,把比较结果写到 <out> |
--automerge <a> <b> <base> -o <out> |
合并并写出结果;有冲突时失败,除非指定偏向哪一侧 |
--favor-left、--favor-right |
自动合并时冲突取这一侧(必须和 --automerge 一起用) |
--script=<文件> [%1 …] |
无界面运行脚本;后面的参数就是 %1…%9 |
--silent |
脚本运行时什么都不打印(只能和 --script 一起用) |
讲不通的组合会直接报错并说明原因,而不是猜你想干什么:--silent 没带 --script、
--favor-left 没带 --automerge、给合并出报告、给合并加 --readonly 等等。
Beyond Compare 的脚本(.bcs)不能直接跑。在脚本会话里导入,转换器会说明它改了什么,
见脚本。
退出码
| 退出码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 二进制相同 |
| 2 | 按规则相同 |
| 11 | 二进制不同 |
| 12 | 相似 |
| 13 | 按规则不同 |
| 14 | 有冲突 |
| 100 | 未知错误 |
| 101 | 有冲突,合并结果未写出 |
| 102 | 无法等待主程序结束 |
| 103 | 找不到 GeeCompare 主程序 |
| 104 | 许可证无效或试用已过期 |
| 105 | 无法读取脚本文件 |
| 106 | 脚本语法错误 |
| 107 | 脚本无法加载文件或文件夹 |
1 和 2(以及 11、12、13)把「字节一样所以相同」和「按规则算相同」分开,这正是 --quick=rules
在构建里有用的地方:只差一个注释或换行符的文件可以放行,真正的改动才让构建停下。
GeeCompare 是免费的,永远不会返回 104;它在表里只是为了和 Beyond Compare 的脚本对得上。
几个例子
# 忽略规则认定的次要差异后,还有不同吗?
geecompare --quick=rules build/out dist/out || echo "有差异($?)"
# 每晚给两棵目录树出一份 HTML 报告
geecompare --report=~/reports/folders.gcrs /srv/a /srv/b /tmp/report.html
# 不开窗口做合并,冲突时保留我方
geecompare --automerge --favor-left mine.c theirs.c base.c -o merged.c
# 带三个参数跑脚本
geecompare --script=nightly.gcs /srv/a /srv/b /var/log/compare
最后更新:2026-11-22