// 文档

脚本

脚本语言、全部命令、参数怎么传,以及 Beyond Compare 脚本怎么导入。

脚本就是一个文本文件,一行一条命令,不开窗口运行:

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