Python使用?Spire.PDF合并多個PDF文件

更新時間：2026年04月22日 09:35:02 作者：Metaphor692

在日常辦公和文檔管理中,我們經(jīng)常需要將多個獨立的 PDF 文件整合成一個完整的文檔,本文將介紹如何使用 Python 和 Spire.PDF 庫來合并多個 PDF 文件,幫助您高效地完成文檔整合任務

為什么需要合并 PDF 文件

合并 PDF 文件在實際工作中有著廣泛的應用場景：

文檔整合：將分散的章節(jié)、附錄或補充材料合并成完整的報告或手冊
檔案管理：將相關的多份文件（如合同、附件、補充協(xié)議）整理為單一檔案
簡化分享：將多個小文件合并為一個，便于通過郵件發(fā)送或在線分享
批量處理：自動化合并大量 PDF 文件，提高工作效率
保持格式：與轉(zhuǎn)換為其他格式再合并相比，直接合并 PDF 可以保持原有的排版和樣式

通過 Python 自動化這一過程，可以快速處理大量文件，避免手動操作的繁瑣和出錯風險。

環(huán)境準備

首先，需要安裝 Spire.PDF for Python 庫?？梢酝ㄟ^ pip 命令輕松完成安裝：

pip install Spire.PDF

安裝完成后，即可在 Python 腳本中導入該庫并使用其提供的文檔合并功能。

基礎合并：通過選擇頁面構建新 PDF

使用 InsertPage 和 InsertPageRange 方法

除了簡單的全文合并，Spire.PDF 還允許我們創(chuàng)建一個全新的 PDF 文檔，并從現(xiàn)有的多個 PDF 文件中挑選特定頁面或頁面范圍進行組合。這種方法非常適合需要對頁面順序進行重組或僅提取部分內(nèi)容的場景。

以下代碼演示了如何從三個不同的 PDF 文件中提取特定頁面，并將它們整合到一個新的文檔中：

from spire.pdf import *
from spire.pdf.common import *

# 定義要處理的 PDF 文件路徑
file1 = "示例1.pdf"
file2 = "示例2.pdf"
file3 = "示例3.pdf"
files = [file1, file2, file3]

# 加載所有 PDF 文件
pdfs = []
for file in files:
    # 實例化 PdfDocument 對象并加載文件
    doc = PdfDocument()
    doc.LoadFromFile(file)
    pdfs.append(doc)

# 創(chuàng)建一個新的空 PDF 對象（用于存放合并后的頁面）
newPdf = PdfDocument()

# 策略 1：插入單個頁面 (InsertPage)
# 將第一個文檔的第 1 頁（索引 0）插入新文檔
newPdf.InsertPage(pdfs[0], 0)
# 將第二個文檔的第 2 頁（索引 1）插入新文檔
newPdf.InsertPage(pdfs[1], 1)

# 策略 2：批量插入頁面范圍 (InsertPageRange)
# 將第三個文檔的第 1 頁到第 2 頁（索引 0 到 1）一次性插入新文檔
newPdf.InsertPageRange(pdfs[2], 0, 1)

# 保存合并后的新 PDF 文檔
newPdf.SaveToFile("output/復制頁面合并PDF.pdf")

# 關閉資源
newPdf.Close()
for pdf in pdfs:
    pdf.Close()

這段代碼展示了精準控制頁面合并的兩種核心技術：

InsertPage 方法：用于從源文檔中提取單個特定頁面。它接受源文檔對象和頁面索引作為參數(shù)。在示例中，我們分別從前兩個文檔中各取一頁放入新文檔。
InsertPageRange 方法：用于批量提取頁面范圍。它接受三個參數(shù)：源文檔對象、起始頁面索引和結(jié)束頁面索引。相比多次調(diào)用 InsertPage，這種方法在處理連續(xù)章節(jié)合并時效率更高。

通過這種方式，你可以打破原有的文檔結(jié)構，像積木一樣自由組合來自不同來源的頁面，生成一個完全定制化的新 PDF 文件。

高級合并：使用流進行合并

使用 PdfMerger.MergeByStream 方法

除了基于文檔對象的合并方式，Spire.PDF 還提供了基于流的合并功能。這種方法特別適合處理來自網(wǎng)絡或內(nèi)存中的 PDF 數(shù)據(jù)，無需先將數(shù)據(jù)保存到磁盤文件。

以下示例展示了如何通過流的方式合并多個 PDF 文件：

from spire.pdf.common import *
from spire.pdf import *

# 定義輸入文件路徑和輸出流
inputFile1 = "./Demos/Data/MergePdfsTemplate_1.pdf"
inputFile2 = "./Demos/Data/MergePdfsTemplate_2.pdf"
inputFile3 = "./Demos/Data/MergePdfsTemplate_3.pdf"
outputFile = Stream("MergeFilesByStream.pdf")

# 創(chuàng)建 PDF 文檔流
stream1 = Stream(inputFile1)
stream2 = Stream(inputFile2)
stream3 = Stream(inputFile3)

# 將所有流放入列表
streams = [stream1, stream2, stream3]

# 創(chuàng)建合并選項
mergeOp = MergerOptions()

# 通過流合并 PDF 文件
PdfMerger.MergeByStream(streams, outputFile, mergeOp)

這種基于流的合并方法有以下優(yōu)勢：

內(nèi)存效率：可以直接處理內(nèi)存中的數(shù)據(jù)，減少磁盤 I/O 操作
網(wǎng)絡友好：適合處理從網(wǎng)絡下載的 PDF 數(shù)據(jù)，無需先保存到本地
簡潔高效：一行代碼即可完成多個文件的合并，代碼更加簡潔

MergerOptions 類允許您配置合并過程中的各種選項，例如是否保留書簽、如何處理元數(shù)據(jù)等。雖然本示例使用了默認設置，但在實際應用中可以根據(jù)需要進行自定義配置。

實際應用

PDF 合并功能在實際工作中有廣泛的應用場景：

批量合并文件夾中的所有 PDF

當需要將某個文件夾中的所有 PDF 文件按名稱順序合并時，可以編寫批處理函數(shù)來自動化這一過程。以下是一個實用的批量合并示例：

from spire.pdf.common import *
from spire.pdf import *
import os
import glob

def MergePdfFolder(input_folder: str, output_file: str):
    """將文件夾中的所有 PDF 文件按名稱順序合并"""
    
    # 獲取文件夾中所有的 PDF 文件并按名稱排序
    pdf_files = sorted(glob.glob(os.path.join(input_folder, "*.pdf")))
    
    if not pdf_files:
        print("未找到 PDF 文件")
        return
    
    print(f"找到 {len(pdf_files)} 個 PDF 文件，開始合并...")
    
    # 加載第一個 PDF 文檔作為基礎文檔
    main_doc = PdfDocument()
    main_doc.LoadFromFile(pdf_files[0])
    print(f"已加載基礎文檔: {os.path.basename(pdf_files[0])}")
    
    # 依次將其他文檔追加到基礎文檔
    for i in range(1, len(pdf_files)):
        temp_doc = PdfDocument()
        temp_doc.LoadFromFile(pdf_files[i])
        main_doc.AppendPage(temp_doc)
        temp_doc.Close()
        print(f"已合并: {os.path.basename(pdf_files[i])}")
    
    # 保存合并后的文件
    main_doc.SaveToFile(output_file)
    main_doc.Close()
    
    print(f"\n合并完成！輸出文件: {output_file}")
    print(f"總共合并了 {len(pdf_files)} 個文件")

# 使用示例
input_folder = "./PDF文檔"
output_file = "合并結(jié)果.pdf"
MergePdfFolder(input_folder, output_file)

這個函數(shù)會自動掃描指定文件夾中的所有 PDF 文件，按文件名排序后依次合并，非常適合處理章節(jié)化的文檔或系列報告。