如何使用 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 for 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 前，先檢查該檔案是否可讀。 若想了解社群開發者如何處理類似的合併錯誤情境，Stack Overflow 上關於在 Node.js 中合併 PDF 的討論串可提供更多背景資訊。

在 Node.js 中合併 PDF 的下一步該怎麼做？

上述範例涵蓋了最常見的合併情境：基本檔案合併、頁面範圍選取、頁首與頁尾插入、密碼保護，以及數位簽章。 IronPDF 亦支援跨合併頁面的 PDF 表單管理、將新內容疊印至合併文件，以及從最終輸出產生點陣圖以供預覽。

立即開始 30 天試用，體驗無浮水印的合併功能；若您已準備好部署，亦可查看授權方案。

準備好探索 IronPDF 的更多功能了嗎？ 請參閱 IronPDF for Node.js 文件，以獲取完整的 API 操作指南及更多實用教學。