如何使用 Java 合并两个 PDF 文件

合并前渲染 HTML 部分

下面的示例将两个独立的 HTML 字符串加载到内存中，并将其合并为一个文档。 此模式适用于报表生成器、发票Builder，以及任何通过编程方式从模板或数据库行中组装内容的系统。

```java {title="合并动态生成的 PDF"} //:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-html-pdfs.java import com.ironsoftware.IronPdf.PdfDocument; import java.io.IOException; import java.nio.file.Paths;

public class Main { public static void main(String[] args) throws IOException { // 每个文档部分的 HTML 内容 String htmlA = "

First part of the report.

Second part of the report.

    // 将每个 HTML 字符串在内存中渲染为 PDF —— 无需写入磁盘
    PdfDocument pdfA = PdfDocument.renderHtmlAsPdf(htmlA);
    PdfDocument pdfB = PdfDocument.renderHtmlAsPdf(htmlB);

    // 将两份文档合并为一个PDF文件
    PdfDocument merged = PdfDocument.merge(pdfA, pdfB);

    // 保存合并后的结果
    merged.saveAs(Paths.get("assets/merged.pdf"));
}

}

合并后的输出按参数顺序拼接页面：`pdfA` 页面出现在 `pdfB` 页面之前。 如需了解 HTML 渲染引擎的完整操作指南，请参阅 [IronPDF for Java](https://ironpdf.com/java/tutorials/html-to-pdf/) 的 [HTML 转 PDF 教程](https://ironpdf.com/java/tutorials/html-to-pdf/)。

![显示已成功合并文档的PDF阅读器——左侧为第一个PDF，右侧为带有导航控件的第二个PDF](/static-assets/ironpdf-java/howto/how-to-merge-two-pdf-files-java-tutorial/how-to-merge-two-pdf-files-java-tutorial-5.webp)

重要 `renderHtmlAsPdf()` 调用使用基于 Chromium 的渲染引擎。全面支持 CSS、网页字体和内联图片——输出效果与浏览器显示完全一致。

## 如何合并现有的 PDF 文件？

从磁盘加载 PDF 并将其合并的操作遵循相同的模式，即使用 `PdfDocument.fromFile()` 将每个文件读入内存，然后将对象传递给 `merge()`。

此方案适用于源文档已存在的任何工作流程——例如扫描的发票、导出的报告或从外部系统接收的文件。 IronPDF 会读取 PDF 结构并合并页面，且不会更改原始源文件。

### 从磁盘加载和合并文件

```java {title="合并磁盘上的现有 PDF 文件"}
//:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-existing-files.java
import com.ironsoftware.IronPdf.PdfDocument;
import java.io.IOException;
import java.nio.file.Paths;

public class Main {
    public static void main(String[] args) throws IOException {
        // 从磁盘加载两个现有的 PDF 文件
        PdfDocument pdfA = PdfDocument.fromFile(Paths.get("assets/invoice-january.pdf"));
        PdfDocument pdfB = PdfDocument.fromFile(Paths.get("assets/invoice-february.pdf"));

        // 合并为一个文档
        PdfDocument merged = PdfDocument.merge(pdfA, pdfB);

        // 写入合并后的输出内容 -- 原文保持不变
        merged.saveAs(Paths.get("assets/invoices-q1.PDF"));
    }
}

merge() 调用会生成一个新的 PdfDocument 对象； 既不修改 pdfA，也不修改 pdfB。 若需执行反向操作（即重新提取页面），请参阅 Java 版拆分 PDF 示例。

fromFile() 支持哪些文件格式？

PdfDocument.fromFile() 支持标准 .pdf 文件格式。 对于需要转换后才能合并的文档（例如 HTML 文件、图像文件或其他格式），请先使用适当的渲染方法（renderUrlAsPdf()) 生成 PdfDocument，再将该对象传递给 merge()。

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

Iron Suite 在我们的运营中起着至关重要的作用。这些工具提高了业务各方面的效率，包括创建平面图和改善库存管理。

David Jones

首席软件工程师，Agorus Build

查看案例研究

可变参数与基于列表的模式

以下两种写法产生的结果完全相同。 当文件数量固定时，请选择直接调用 varargs；若需通过编程方式构建集合，请采用列表转数组模式：

```java {title="合并四个 PDF 文件——可变参数与列表方法"} //:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-multiple-files.java import com.ironsoftware.IronPdf.PdfDocument; import java.io.IOException; import java.nio.file.Paths; import java.util.ArrayList; import java.util.List;

public class Main { public static void main(String[] args) throws IOException { // 加载四个现有的 PDF 文件 PdfDocument pdfA = PdfDocument.fromFile(Paths.get("assets/chapter-1.pdf")); PdfDocument pdfB = PdfDocument.fromFile(Paths.get("assets/chapter-2.pdf")); PdfDocument pdfC = PdfDocument.fromFile(Paths.get("assets/chapter-3.pdf")); PdfDocument pdfD = PdfDocument.fromFile(Paths.get("assets/chapter-4.pdf"));

    // 模式 1：直接调用可变参数 -- 适用于文件数量固定的情况
    PdfDocument merged = PdfDocument.merge(pdfA, pdfB, pdfC, pdfD);
    merged.saveAs(Paths.get("assets/full-document.pdf"));

    // 模式 2：先构建列表——当文件数量动态变化时推荐使用
    List<pdfdocument> pdfList = new ArrayList&lt;&gt;();</pdfdocument>
    pdfList.add(pdfA);
    pdfList.add(pdfB);
    pdfList.add(pdfC);
    pdfList.add(pdfD);

    PdfDocument mergedFromList = PdfDocument.merge(
        pdfList.toArray(new PdfDocument[0])
    );
    mergedFromList.saveAs(Paths.get(&quot;assets/full-document-v2.pdf&quot;));
}

}

重要输出页面的顺序必须与参数顺序完全一致。 如果文档顺序很重要——例如书籍的章节或表单的有序部分——请在调用 `merge()`.
 之前对列表进行排序。)}]

### 如何扫描目录并合并所有 PDF 文件？

当在编译时无法确定输入文件集时，从目录中读取文件路径是列表模式的自然延伸。 下面的代码片段会从文件夹中收集所有 `.pdf` 文件，按文件名排序，并按顺序合并它们。

```java {title="扫描目录并合并所有 PDF 文件"}
//:path=/static-assets/pdf/content-code-examples/how-to/how-to-merge-two-pdf-files-java-tutorial/merge-directory-pdfs.java
import com.ironsoftware.IronPdf.PdfDocument;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
import java.util.stream.Collectors;

public class Main {
    public static void main(String[] args) throws IOException {
        Path inputDir = Paths.get("assets/monthly-reports");

        // 从目录中收集所有 PDF 文件，并按文件名排序
        List<path> pdfPaths = Files.list(inputDir)</path>
            .filter(p -&gt; p.toString().endsWith(&quot;.pdf&quot;))
            .sorted(Comparator.comparing(Path::getFileName))
            .collect(Collectors.toList());

        // 将每个文件加载到 PdfDocument 中
        List<pdfdocument> documents = new ArrayList&lt;&gt;();</pdfdocument>
        for (Path path : pdfPaths) {
            documents.add(PdfDocument.fromFile(path));
        }

        // 合并所有文档并保存结果
        PdfDocument combined = PdfDocument.merge(
            documents.toArray(new PdfDocument[0])
        );
        combined.saveAs(Paths.get(&quot;assets/annual-report.pdf&quot;));
    }
}

此模式可处理任意大小的文件夹。对于大型批次（50 个以上文件），建议分批加载并合并，以限制峰值内存使用，而非同时加载所有文件。

合并后，您可能需要进一步润色合并后的文档。 IronPDF for Java 支持添加自定义页眉和页脚、应用水印，以及压缩最终输出文件，以便在交付前减小文件大小。