如何使用 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 檔案、圖像檔案或其他格式），請先使用適當的渲染方法 (renderHtmlAsPdf(), renderUrlAsPdf()) 產生 PdfDocument，再將該物件傳遞給 merge()。

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官，OPYN

查看案例研究

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

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 支援新增自訂頁首與頁尾、套用浮水印，以及壓縮最終輸出檔案，以在交付前縮小檔案大小。