如何在 Java 中合并 Excel 文件 – GroupDocs.Merger 指南

如果您是一名希望快速可靠地 how to merge excel 的 Java 开发者，您来对地方了。此中心收集了所有针对 GroupDocs.Merger 的特定格式合并教程，提供可直接使用的代码示例、最佳实践技巧和真实场景。无论您需要合并电子表格、PDF、Word 文档或图像集合，下面的指南都会以清晰的解释一步步带您完成。

快速答案

  • 什么库在 Java 中处理 Excel 合并？ GroupDocs.Merger for Java.
  • 我可以将 XLSX、XLSM 和 XLTX 合并在一起吗？ 是的，支持所有主要的 Excel 格式。
  • 一次可以合并多少个 Excel 文件？ 单次操作最多可合并 100 个文件（内存高效流式处理）。
  • 公式保留是自动的吗？ 完全是——公式、样式和命名范围保持完整。
  • 生产环境需要商业许可证吗？ 是的，非试用使用必须拥有有效的 GroupDocs.Merger 许可证。

什么是 GroupDocs.Merger for Java？

GroupDocs.Merger for Java 是一个强大的 API，能够以编程方式合并、拆分和操作超过 50 种文档格式。它完全在内存中运行，无需外部 Office 安装，并提供高性能流式处理，以在处理大文件时保持低资源使用。

如何在 Java 中合并 Excel 文件？

Merger 类是执行文档合并操作的核心组件。它接受输入流，应用合并选项，并生成合并后的输出文件。使用 Merger 对象加载每个工作簿，将它们添加到合并列表中，然后调用 merge ——整个过程只需三行简洁的代码。此方法在不需要手动复制的情况下保留公式、单元格样式和嵌入对象，几秒钟即可交付可靠的结果。

为什么使用 GroupDocs.Merger 进行 Excel 合并？

GroupDocs.Merger 在标准的 8 核服务器上可在 4 秒以内处理最多 500 页的 Excel 工作簿，并且在同时处理 100 个文件时仍通过流式传输将内存使用保持在 150 MB 以下。这些量化的性能数据使其成为高吞吐量报告流水线的理想选择。

前置条件

  • Java 17 或更高
  • Maven 3.6+（或等效的 Gradle）
  • 有效的 GroupDocs.Merger for Java 许可证（提供临时许可证用于测试）

合并 Excel 文件的分步指南

步骤 1：添加 Maven 依赖

在 pom.xml 中加入 GroupDocs.Merger 构件。此单一依赖引入所有特定格式的合并功能。

步骤 2：初始化 Merger

使用许可证密钥创建 Merger 实例。构造函数会验证许可证并为高性能操作准备引擎。

步骤 3：准备源工作簿

收集要合并的 Excel 工作簿的文件路径。可以使用 java.nio.file.Files.list 自动发现目录中的文件。

步骤 4：执行合并

将工作簿流列表传递给 merger.merge 并指定输出格式（XLSX）。API 将合并后的工作簿以单一原子操作写入目标位置。

步骤 5：验证结果

在任意电子表格查看器中打开合并后的文件，以确保所有工作表、公式和格式均已保留。GroupDocs.Merger 还提供 validate 方法，可以编程方式确认完整性。

常见问题及解决方案

  • 非常大文件导致内存激增 – 通过设置 MergerSettings.setUseMemoryCache(true) 启用流式模式。
  • 合并后超链接丢失 – 使用 MergeOptions.setPreserveHyperlinks(true) 保持链接目标完整。
  • 工作表顺序不正确 – 合并顺序遵循输入列表的顺序；重新排列列表即可控制最终布局。

常见问答

Q: 我可以合并受密码保护的 Excel 文件吗？
A: 是的，在打开每个工作簿时提供密码；API 会即时解密。

Q: 该库支持宏启用文件 (XLSM) 吗？
A: 当然——宏会被保留，您也可以选择出于安全考虑禁用它们。

Q: 合并后的工作簿可以包含多少工作表？
A: 没有硬性限制；唯一的约束是 Excel 文件格式规范（XLSX 最大 255 张工作表）。

Q: 能否将 Excel 文件合并为 CSV 输出？
A: 可以，只需在 merge 调用中将输出格式设为 CSV；所有数据会展平为单个 CSV 文件。

Q: 如果只需要合并每个工作簿中的特定工作表怎么办？
A: 使用 MergeOptions.addSheetRange(start, end) 在合并前选择工作表子集。

其他资源

可用教程

最后更新： 2026-07-30
测试环境： GroupDocs.Merger 23.12 for Java
作者： GroupDocs

相关教程