// 文档

命令行

在终端里比较、合并、出报告和跑脚本,以及每个退出码的含义。

命令是 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