4 种 Excel 转 PDF 布局选项在 Java 中的比较

配套示例仓库(待发布): excel-pdf-pagination-java

Excel 转 PDF 分页是一个针对 Java 的 GroupDocs.Conversion 工作流,用于决定电子表格的行列在输出页面上的呈现方式。关键问题不仅是转换是否成功,而是报告是否以读者可用的形式呈现。本比较在 26.10 版本上对同一工作簿使用四种策略进行测试,并记录页数以及物理尺寸。这两个度量揭示了不同的细节。

介绍

工作表是一个灵活的画布;PDF 页面则有固定的物理边界。当报告将相关列相距甚远或使用空行分隔章节时,这种差异会变得明显。导出可能会保留间距并水平拆分表格;另一种设置可能通过加宽页面将所有列聚合在一起;第三种则会去除作者有意在块之间留下的空隙。仅凭成功信息无法判断这些结果。

示例使用一个虚构的单工作表报告,以保证比较可复现。数据分布在八列有内容的列中,组间有空列。第 1、2、3、12、13、40 行包含标记。工作簿指定 A4 纵向纸张和一英寸的源边距。我们在运行四种方法时保持该文件不变,然后检查生成的 PDF,而不是假设页数更少就意味着导出更好。

为什么布局比较很重要

这些选项解决不同的问题。AllColumnsInOnePagePerSheet 处理水平分组;SkipEmptyRowsAndColumns 处理空白间距;OnePagePerSheet 提供工作表级概览。默认转换则作为对照基准,以评估每项策略的效果。将这些情况分开,有助于向批准报告的人员解释变化。

对于 Java 26.10,all-columns 和 skip-empty 标志默认均为 false。当代码依赖隐式设置而非显式声明导出策略时,这一点尤为重要。底层选项并非全部是本次发布的新特性。本文记录了它们在 26.10 版本中与随附固定文件的交互测试结果,并不提供速度基准或对任意工作簿的固定页数声明。

哪个选项能让 Excel 报告保持在 A4?

在随附的固定文件中,默认和 skip-empty 变体会生成 A4 页面,而 all-columns 与 one-page-per-sheet 会产生自定义尺寸。这是实际测得的结果,并非对所有情况的 A4 保证。请检查工作簿的页面设置并在交付前验证输出尺寸。如果接收系统要求固定纸张尺寸,请将此要求写入验收测试,而不是依赖页数。

前置条件

使用 JDK 11 或 17、Maven 和 GroupDocs.Conversion for Java 26.10。项目中包含 documents/report.xlsx,运行时会在 Result/ 目录生成文件。需要一份覆盖该版本的许可证,以完成无限制验证,因为评估版限制可能会中断多页输出。分发的源码中有许可证占位符;请将真实许可证放在项目外部。每种方法都会打开一个新的 Converter,并在保存 PDF 后关闭它。

安装

完整项目提供了 GroupDocs 仓库和此 Maven 依赖。请在包含 pom.xml 的目录下运行命令,以便相对文档路径能够解析。下面的 Java 代码块是提取的方法体,完整项目已提供 import 和目录设置。示例不调用任何电子表格编辑器。

<dependency>
  <groupId>com.groupdocs</groupId>
  <artifactId>groupdocs-conversion</artifactId>
  <version>26.10</version>
</dependency>
mvn compile exec:java

方法 1:建立默认导出

从一个使用默认 SpreadsheetLoadOptions 的 Converter 开始。这是比较的基准文件。固定文件中的空行和空列对布局仍然有意义,宽表格会水平断开。结果为三页,尺寸约为 595.44 × 841.68 点,pdfinfo 将其识别为 A4。即使这不是你最终交付的版本,也请保留此输出。

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert("Result/01-defaults.pdf", new PdfConvertOptions());
}

基准回答了一个实际问题:切换单个标志会产生什么变化?如果没有这个基准,紧凑的报告可能会被误认为是由于工作簿的其他编辑或不同的源文件导致的。我会在集成过程中使用不同的文件名保存这些比较输出,正如示例所示。这样视觉审查就不那么模糊。原始工作簿保持不变,审阅者始终拥有相同的起点。

方法 2:将所有列聚合在一起

第二种方法启用 AllColumnsInOnePagePerSheet。在固定文件中,A 列到 L 列的单元格现在出现在同一张更宽的 PDF 页面上。由于 SkipEmptyRowsAndColumns 仍为 false,空白间距仍然保留。PDF 尺寸为 1138.32 × 841.68 点。高度与基准页高度相同,但宽度不同。

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setAllColumnsInOnePagePerSheet(true);
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert("Result/02-all-columns.pdf", new PdfConvertOptions());
}

这对希望在相关列组之间横向追踪同一行的审阅者很有帮助。代价是物理页面尺寸增大。PDF 查看器在窗口适配时可能会让宽幅结果看起来舒适,但打印时会引入另一个缩放决策。还要记住,这个工作簿在垂直方向上是适配的。更多行数可能导致不同报告表现不同;此设置并未建立通用的“一页工作簿”规则。

方法 3:去除空白间距

紧凑导出启用 SkipEmptyRowsAndColumns,其余策略保持默认。在固定文件中,被大量空白区域分隔的行标记会靠得更近,空列间隙也会消失。输出占用两页 A4,而不是基准的三页。由于未启用 AllColumnsInOnePagePerSheet,列仍可能水平拆分。

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setSkipEmptyRowsAndColumns(true);
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert("Result/03-skip-empty.pdf", new PdfConvertOptions());
}

当间隙是偶然出现而非报告设计的一部分时使用此变体。空行可以是视觉分隔符、签名占位或表单的一部分。删除它可能会让数值报告更短,却会削弱结构化表单的可用性。我们特意将其作为独立运行保留下来。若立即与 all-columns 分组结合使用,会掩盖是哪项设置导致了观察到的变化。

方法 4:将整张工作表放在一页上

OnePagePerSheet 将整个工作表聚合到一张 PDF 页面。我们的输入只有一张工作表,因此结果只有一页。其尺寸为 1138.32 × 638.237 点,既不同于基准也不同于 all-columns 情况。这是一个自定义画布的工作表概览,并不意味着同一报告被强行适配到 A4 纸张。

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setOnePagePerSheet(true);
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert("Result/04-one-page.pdf", new PdfConvertOptions());
}

我会在仅用于屏幕审阅的情况下选择此策略,并在读者将使用的缩放级别下打开结果。单页缩略图对密集报告中的小字号几乎没有说明意义。当页面边界成为干扰因素时,此设置可能合适,但其输出仍需进行验收检查。请在将其设为应用默认之前,先使用具有代表性的工作簿进行验证。随附的虚构报告提供了可重复的起点,而非通用的布局规范。

方法比较:何时使用每种

导出方式 页数 页面尺寸(点) 主要权衡
默认 3 595.44 x 841.68 相关列可能被拆分
所有列聚合 1 1138.32 x 841.68 页面物理宽度增大
跳过空行空列 2 595.44 x 841.68 有意的间隙会消失
每工作表一页 1 1138.32 x 638.237 自定义工作表尺寸概览

四种已验证的 Excel PDF 布局的首页预览

该图仅展示每个输出的首页。为了便于比较,图中的列会按比例缩放,因此显示的尺寸并不等同于实际纸张大小。请使用表格和实际 PDF 属性来做决定。项目运行时,完整文件会写入 Result/。在批准前,请检查默认版和紧凑版的其余页面。

最佳实践与提示

先记录接收系统的需求。打印机可能需要 A4,而内部审阅者可能更喜欢宽页。表单可能需要保留空白,而仅数据报告可以去除这些空白。这些选择应体现在导出策略中,而不是假设最短的 PDF 就是最佳。我们建议为每个报告模板保留一个具代表性的工作簿,并在更改后重新运行比较。

将物理尺寸视为测试数据。页数告诉你分页发生了多少,但并不能说明列是否保持在一起或文字是否易读。示例的尺寸是通过在 Java 11.0.2 上授权执行后使用 Poppler pdfinfo 获得的。页面预览是单独渲染的。两者都不是性能测量,也不能替代对真实报告的审查。

将边距声明与分组声明分开。一次针对 26.10 的检查将 PdfConvertOptions 边距设为 36 点,产生的渲染与默认电子表格输出完全相同。因此本比较并不保证通过该路径覆盖边距。如果显式边距是需求,请在将其作为解决方案的一部分呈现之前,独立调查并验证。

结论

在提供的工作簿上运行四种方法,然后与实际批准的报告进行比较。根据读者需求和接收系统的页面尺寸要求选择分组策略。确认间距和物理尺寸后再设为默认。保留基准,以便在下一个版本升级时拥有具体的比较依据。

其他资源