如何将多个 PDF 文件合并为一个 PDF 文档

先了解合并方式

如果你手上有两份或更多 PDF，需要把它们整理成一个文件，可以使用 PDF Merger。它会读取你提供的 Base64 编码 PDF 文件，并按照文件列表的顺序合并页面，适合整理报告、合同附件或分批导出的资料。处理成功后，结果是一个同样以 Base64 编码返回的合并 PDF，并附带已处理页面数和合并文件数。

合并多个 PDF 的步骤

1. 准备至少两个 PDF 文件，并确认每个文件值都是对应 PDF 的 Base64 编码内容。
2. 按希望出现的先后顺序建立文件列表。例如，把封面文件放在第一项，正文文件放在第二项，附件放在后面。工具会先处理列表中的第一个文件，再依次处理后续文件；每个文件内部的页面顺序也会保留。
3. 将这份文件列表提供给工具并开始处理。不要省略文件列表，也不要只提供一个文件。未提供可用列表时会按空列表处理，而少于两个文件不会形成成功的合并结果。
4. 检查处理状态。成功时保存返回的 Base64 合并 PDF，并查看返回的页面数和文件数；如果失败，查看错误信息，确认文件数量、Base64 内容和 PDF 格式后再处理。

如何看懂结果

成功结果应包含一个 Base64 编码的 PDF，以及已处理页面数和已合并文件数。页面排列应与输入列表一致：第一份文件的页面在前，第二份文件的页面紧随其后，每份文件内部仍按原有顺序排列。结果只说明合并处理已返回，不代表工具会替你修复损坏的 PDF 或转换其他文件类型。

如果结果显示失败，可能是提供的文件少于两个、某个文件无法按 PDF 读取，或处理过程出现异常；PDF 相关依赖不可用时也会报告失败。此时先核对输入数量与每个文件的编码和格式，再根据错误信息处理。

使用示例

你需要把一份封面、一个正文 PDF 和一份附件整理成单个文档。

将封面、正文和附件三个 PDF 的 Base64 文件值按此顺序放入文件列表后处理。

成功返回一个 Base64 编码的合并 PDF，并附带已处理页面数和已合并文件数；页面顺序为封面、正文、附件。

使用限制

• 如果 PDF 相关依赖不可用、文件少于两个、文件无法按 PDF 读取，或处理过程中出现异常，操作会报告失败。

常见错误

• 常见原因是只提供一个文件，或没有提供可用的文件列表。请改为提供至少两个可读取的 Base64 PDF 文件，并按所需顺序放入列表。

常见问题

可以只合并一个 PDF 文件吗？

可以，但前提是文件列表中至少有两个可读取的 Base64 PDF 文件；只提供一个文件会报告失败。

合并后页面顺序会保留吗？

可以。工具会按照文件列表的先后顺序添加文件，并保留每个文件内部的页面顺序。

处理成功或失败后会返回什么？

处理成功时会返回 Base64 编码的合并 PDF，并附带已处理页面数和已合并文件数；如果输入不足两个文件、PDF 无法读取或处理发生异常，则会报告失败并提供错误信息。