脚本就是一个文本文件,一行一条命令,不开窗口运行:
geecompare --script=nightly.gcs /srv/a /srv/b /var/log/compare
脚本后面的参数就是 %1 … %9;%date%、%TEMP% 和其它环境变量也会展开。行尾的 & 表示
续行,# 开头是注释。脚本会话(主页 › 脚本)用的是同一套语言,另外带编辑器、命令参考、
逐行显示执行情况的运行面板,以及最后的退出码。
一个脚本
log verbose "%TEMP%/nightly.log"
option confirm:yes-to-all
option stop-on-error
criteria timestamp:2sec size crc
filter "*.dll;*.so;*.dylib;*.json;-*.pdb;-obj\;-.cache\"
load "%1" "%2"
expand all
select left.newer.files left.orphan.files
compare rules-based
copy left->right
sync create-empty mirror:left->right
folder-report layout:side-by-side options:display-mismatches,column-crc &
output-to:"%3/folders.html" output-options:html-color
命令
会话
| 命令 | 语法 | 作用 |
|---|---|---|
load |
load <左> [<右>] [<中>] |
载入两个文件夹(或文件、快照、已保存的连接)开始比较 |
criteria |
criteria <条件>… |
什么算相同:timestamp[:2sec]、ignore-dst、size、crc、binary、rules-based |
filter |
filter "<包含>;-<排除>" |
名称过滤,分号分隔,- 开头为排除 |
expand / collapse |
expand <选择器>|all |
展开文件夹(会读取内容)或重新折叠 |
select |
select <选择器>… |
选择项目:left.newer.files、right.orphan.folders、left.diff.files … |
compare |
compare binary|crc|rules-based |
对所选文件做内容比较 |
文件操作
| 命令 | 语法 | 作用 |
|---|---|---|
copy |
copy left->right |
把所选复制到另一侧 |
copyto |
copyto left|right|all path:<方式> "<目标>" |
复制到第三个位置(path:relative、path:base、path:flat) |
move / moveto |
move left->right |
移动到另一侧,或移动到第三个位置 |
delete |
delete <选择器> |
删除所选(加了 option recycle-bin 就进回收站) |
rename |
rename "<旧名>" "<新名>" |
重命名一个项目 |
touch |
touch left->right |
修改时间 |
attrib |
attrib [+-]r [+-]a [+-]h [+-]s <选择器> |
DOS 属性(文件系统不支持时跳过) |
sync |
sync [create-empty] update|mirror:<方向> |
同步两侧 |
快照与报告
| 命令 | 语法 | 作用 |
|---|---|---|
snapshot |
snapshot save-crc left output:"<文件>" |
写出文件系统快照(名字、大小、时间,可选 CRC) |
folder-report |
folder-report layout:… options:… output-to:… |
文件夹比较的报告,可以给每个有差异的文件附一份 |
text-report、table-report、hex-report、picture-report |
… layout:… output-to:… |
按对应会话的形态,给所选文件生成报告 |
控制
| 命令 | 语法 | 作用 |
|---|---|---|
option |
option confirm:yes-to-all|stop-on-error|recycle-bin |
运行时的行为 |
log |
log normal|verbose [append:]"<文件>" |
写日志 |
# |
# <注释> |
注释 |
运行结束会给出一个退出码:全部跑完是 0;脚本读不了、语法错、加载不了 分别是 105–107;最后一次比较的结论则用比较类的退出码表示。
导入 Beyond Compare 脚本
Beyond Compare 的脚本只能转换,不能照原样运行。在脚本会话里点「导入 BC」,选一个 .bcs 文件:
左边是原脚本,右边是转换后的脚本,逐行对照,每行标注
- 已转换——同一条命令,同样的意思;
- 已调整(附原因)——
;IgnoreDST变成ignore-dst条件;写死的C:\logs改成%TEMP%;load里写死的路径改成%1%2(原值写进脚本头部的注释);BC 3 的file-report即text-report; - 不支持(附原因)——比如
copyto里直接写一个 FTP 地址:GeeCompare 只连已保存的远程连接 (密码在系统钥匙串里),这一行得改成load那个连接。
「把不支持的行保留为注释」决定这些行是否以注释形式带过来。导入会替换编辑器里的内容,可以撤销。
最后更新:2026-11-22