如何使用 Node.js 将 PDF 文件合并为一个 PDF 文件

在Node.js中如何合并多个PDF文件？

PdfDocument.merge() 接受一个 PdfDocument 对象数组，并返回一个新文档，其中包含源文档数组中所有页面的顺序。 该操作是非破坏性的；原始文件对象不会被修改。

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-pdfs.js
const IronPdf = require('ironpdf');

async function mergePdfs(outputFilePath, inputFiles) {
  // Load all source documents in parallel
  const pdfDocs = await Promise.all(
    inputFiles.map(file => IronPdf.PdfDocument.fromFile(file))
  );

  // Combine into one document, preserving page order
  const mergedPdf = await IronPdf.PdfDocument.merge(pdfDocs);

  // Write the result to disk
  await mergedPdf.toFile(outputFilePath);
  console.log(`Merged PDF saved to ${outputFilePath}`);
}

(async () => {
  const inputFiles = ['report-jan.pdf', 'report-feb.pdf', 'report-mar.pdf'];
  await mergePdfs('quarterly-report.pdf', inputFiles);
})();

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-pdfs.js
const IronPdf = require('ironpdf');

async function mergePdfs(outputFilePath, inputFiles) {
  // Load all source documents in parallel
  const pdfDocs = await Promise.all(
    inputFiles.map(file => IronPdf.PdfDocument.fromFile(file))
  );

  // Combine into one document, preserving page order
  const mergedPdf = await IronPdf.PdfDocument.merge(pdfDocs);

  // Write the result to disk
  await mergedPdf.toFile(outputFilePath);
  console.log(`Merged PDF saved to ${outputFilePath}`);
}

(async () => {
  const inputFiles = ['report-jan.pdf', 'report-feb.pdf', 'report-mar.pdf'];
  await mergePdfs('quarterly-report.pdf', inputFiles);
})();

Promise.all() 支持并行加载源文件而非逐个加载，这在处理大型数据集时尤为重要。 merge() 调用会按数组顺序拼接文档，因此请按期望的输出顺序将文件放入数组中。

如何合并每个PDF的特定页面？

传递每个源文档的每一页并不总是目的。 若需合并各输入文件中的特定页面范围，请在将文档传递给 merge() 之前，先提取所需页面。

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-specific-pages.js
const IronPdf = require('ironpdf');

// Each entry specifies a file and the range of pages to include (zero-indexed)
const pageRanges = [
  { file: 'contract.pdf',  startPage: 0, endPage: 2 },
  { file: 'appendix.pdf',  startPage: 0, endPage: 0 },
  { file: 'signature.pdf', startPage: 0, endPage: 0 },
];

async function mergeSpecificPages(outputFile, ranges) {
  const pdfsToMerge = [];

  for (const range of ranges) {
    const pdf = await IronPdf.PdfDocument.fromFile(range.file);
    // extractPages returns a new PdfDocument with only the specified page range
    const pages = pdf.extractPages(range.startPage, range.endPage);
    pdfsToMerge.push(pages);
  }

  const merged = await IronPdf.PdfDocument.merge(pdfsToMerge);
  await merged.toFile(outputFile);
}

mergeSpecificPages('assembled-contract.pdf', pageRanges);

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-specific-pages.js
const IronPdf = require('ironpdf');

// Each entry specifies a file and the range of pages to include (zero-indexed)
const pageRanges = [
  { file: 'contract.pdf',  startPage: 0, endPage: 2 },
  { file: 'appendix.pdf',  startPage: 0, endPage: 0 },
  { file: 'signature.pdf', startPage: 0, endPage: 0 },
];

async function mergeSpecificPages(outputFile, ranges) {
  const pdfsToMerge = [];

  for (const range of ranges) {
    const pdf = await IronPdf.PdfDocument.fromFile(range.file);
    // extractPages returns a new PdfDocument with only the specified page range
    const pages = pdf.extractPages(range.startPage, range.endPage);
    pdfsToMerge.push(pages);
  }

  const merged = await IronPdf.PdfDocument.merge(pdfsToMerge);
  await merged.toFile(outputFile);
}

mergeSpecificPages('assembled-contract.pdf', pageRanges);

extractPages(startPage, endPage) 接受从零开始的页码索引。 传递 0, 0 仅提取第一页，而 0, 2 则提取前三页。 该循环会按 ranges 中出现的顺序构建一个页面范围文档数组，然后 merge() 将其拼接成最终输出。

该模式在从签名页、附录和保存在单独文件中的封面组装合同时很有用。 您可以从每个源中准确收集重要的页面，而不会在磁盘上重复文件。

如何向合并后的PDF添加页眉和页脚？

合并后，在生成的文档中调用 addHtmlHeader() 和 addHtmlFooter()，以在所有页面上应用统一的页眉和页脚。 这些方法接受HTML字符串和一个选项对象。

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-headers-footers.js
const IronPdf = require('ironpdf');

async function mergeWithHeadersFooters(inputFiles, outputFile) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Apply a styled header to every page
  await mergedPdf.addHtmlHeader('<h3 style="color:#333;">Quarterly Report</h3>', {
    height: 25,
    drawDividerLine: true,
  });

  // Apply a page-numbering footer
  await mergedPdf.addHtmlFooter('<p style="font-size:10px;">Page {page} of {total-pages}</p>', {
    height: 20,
    drawDividerLine: true,
  });

  await mergedPdf.toFile(outputFile);
}

mergeWithHeadersFooters(['q1.pdf', 'q2.pdf', 'q3.pdf'], 'annual-report.pdf');

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-headers-footers.js
const IronPdf = require('ironpdf');

async function mergeWithHeadersFooters(inputFiles, outputFile) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Apply a styled header to every page
  await mergedPdf.addHtmlHeader('<h3 style="color:#333;">Quarterly Report</h3>', {
    height: 25,
    drawDividerLine: true,
  });

  // Apply a page-numbering footer
  await mergedPdf.addHtmlFooter('<p style="font-size:10px;">Page {page} of {total-pages}</p>', {
    height: 20,
    drawDividerLine: true,
  });

  await mergedPdf.toFile(outputFile);
}

mergeWithHeadersFooters(['q1.pdf', 'q2.pdf', 'q3.pdf'], 'annual-report.pdf');

占位符 {page} 和 {total-pages} 将在渲染时根据合并文档的页数进行解析。 请使用 drawDividerLine: true 来在视觉上将页眉或页脚与页面内容区分开来。

在合并后应用页眉和页脚意味着合并文档中的每一页都得到相同的处理，无论它来自哪个源文件。 欲了解完整的页眉和页脚配置选项，请参阅HTML页眉和页脚示例。

如何用密码保护合并后的PDF？

合并后，请通过调用 saveAs() 并传入安全选项对象来应用密码保护和权限限制。 这可以防止对合并文档的未经授权访问。

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-security.js
const IronPdf = require('ironpdf');

async function mergeWithSecurity(inputFiles, outputFile) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Restrict the merged document to print-only access
  await mergedPdf.saveAs(outputFile, {
    userPassword: 'viewerpass',
    ownerPassword: 'adminpass',
    allowUserAnnotations: false,
    allowUserCopyPasteContent: false,
    allowUserFormData: false,
    allowUserPrinting: true,
  });
}

mergeWithSecurity(['invoice-1.pdf', 'invoice-2.pdf'], 'secured-invoices.pdf');

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-security.js
const IronPdf = require('ironpdf');

async function mergeWithSecurity(inputFiles, outputFile) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Restrict the merged document to print-only access
  await mergedPdf.saveAs(outputFile, {
    userPassword: 'viewerpass',
    ownerPassword: 'adminpass',
    allowUserAnnotations: false,
    allowUserCopyPasteContent: false,
    allowUserFormData: false,
    allowUserPrinting: true,
  });
}

mergeWithSecurity(['invoice-1.pdf', 'invoice-2.pdf'], 'secured-invoices.pdf');

打开文档时必须包含 userPassword； ownerPassword 用于控制权限设置本身。 在禁用其他权限标志的同时设置 allowUserPrinting: true，可允许收件人打印文档，但禁止编辑、复制和批注。 有关可用权限标志的完整列表，请参阅IronPDF Node.js API参考。

如何合并PDF并添加数字签名？

合并PDF并立即签署结果会生成一个覆盖所有源内容的单一签署文档。 在 merge() 之后添加 applySignature()，以便将数字证书附加到合并后的输出中。

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-signature.js
const IronPdf = require('ironpdf');

async function mergeAndSign(inputFiles, outputFile, pfxPath, pfxPassword) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Attach a digital signature using a PFX certificate
  await mergedPdf.applySignature(pfxPath, pfxPassword);
  await mergedPdf.toFile(outputFile);
}

mergeAndSign(
  ['section-a.pdf', 'section-b.pdf'],
  'signed-report.pdf',
  'certificate.pfx',
  'certpass'
);

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-signature.js
const IronPdf = require('ironpdf');

async function mergeAndSign(inputFiles, outputFile, pfxPath, pfxPassword) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Attach a digital signature using a PFX certificate
  await mergedPdf.applySignature(pfxPath, pfxPassword);
  await mergedPdf.toFile(outputFile);
}

mergeAndSign(
  ['section-a.pdf', 'section-b.pdf'],
  'signed-report.pdf',
  'certificate.pfx',
  'certpass'
);

applySignature() 方法将证书嵌入 PDF 元数据中，以便读者验证文档的完整性。 此工作流程在合同装配管道中很常见，其中多个部分在发布前组合并共同签署。 有关基于证书的签名的完整演练，请参阅数字签名示例。

如何排除常见的PDF合并错误？

合并过程中大多数错误属于四类：文件缺失、内存耗尽、输入损坏和权限问题。 下表列出了最常见的原因以及如何解决它们。

对于特定环境的设置问题，IronPDF变更日志记录已知问题和修复。 如果检查上表后问题仍然存在，请将 merge 调用包裹在 try-catch 代码块中，以显示库的完整错误信息。

Node.js本身提供了用于飞行前路径验证的有用工具。 Node.js 的 fs.promises.access 方法允许您在将文件传递给 IronPDF 前，先检查该文件是否可读。 对于关于社区开发人员如何处理类似合并错误场景的问题，在Node.js中合并PDF的Stack Overflow线程提供了额外的上下文。

在Node.js中合并PDF的下一步是什么？

上述示例涵盖最常见的合并场景：基本文件组合、页面范围选择、页眉和页脚注入、密码保护和数字签名。 IronPDF还支持在合并页面上管理PDF表单、将新内容加盖到合并文档上，以及从最终输出中生成栅格化图像以进行预览生成。

开始您的30天免费试用以测试合并不带水印，或查看许可选项如果您准备部署。

准备看看IronPDF还能做些什么吗？ 访问IronPDF for Node.js文档以获取完整的API演练和其他操作指南。