// 文档

报告

把一次比较变成 HTML、文本、补丁、XML 或 CSV——在窗口里、脚本里和命令行里都能做。

每一种会话都能把当前显示的内容做成报告。「会话 › 报告」打开对话框;预览是真的,按输出的样子分页, 改一个选项就重算一次。

能出什么

类型 是什么
并排 两列并排,和比较视图里看到的一样
摘要 一处差异一行,或者一个有差异的文件一行
交错 一侧接一侧,一处差异接一处差异
补丁 普通、上下文、统一三种格式——patch 和 git apply 认的那种
统计(CSV) 各项计数,给表格软件用
XML 把比较结果当数据输出,给别的程序读

文件夹比较另有一套:并排、摘要、XML,以及「有差异文件的报告」——文件名是链接,点开就是那个文件 自己的报告,作为附件跟在索引旁边。

放什么进去

「包含」可以是全部、只有差异,或者每处差异前后带几行上下文;可以把规则认定的次要差异算进来或排除掉, 可以显示行号、标出字符级差异,也可以只输出选中的行。文件夹报告的「包含」则跟随显示过滤,或者按结论 手动挑(不同、次要、仅左、仅右、相同);两侧的列可以带上大小、时间、CRC32、版本和属性。

输出到哪

彩色 HTML、单色 HTML(色块变成灰条和下划线,适合打印)、带自定义样式表的 HTML(报告直接套用团队的 样式),或者纯文本。输出目标是文件、剪贴板或打印机——打印前有预览:页面缩略图、纸张方向、长行怎么折。

标题、页眉和页脚支持 %title%、%left%、%right%、%date%、%page%、%pages%,边输边在预览里展开。

不开窗口

对话框里的「复制为脚本命令」会把当前这套设置写成一行脚本命令——这是把报告搬进自动化最老实的办法:

folder-report layout:side-by-side options:display-mismatches,column-crc &
    output-to:"%3/folders.html" output-options:html-color

text-report、table-report、hex-report、picture-report 对应各自的会话。在终端里,把设置存成 文件,用 --report 指过去:

geecompare --report=~/reports/folders.gcrs /srv/a /srv/b /tmp/report.html

不会开窗口,退出码会告诉你比较的结论。见命令行和脚本。

最后更新:2026-11-22