如何使用 Python 列印 PDF 檔案

什麼是 IronPDF，它如何協助 PDF 列印？

IronPDF 是一個 Python 函式庫，可讓開發人員建立、處理及轉換 PDF 文件。 該函式庫的列印支援涵蓋兩種模式：透過單一方法呼叫直接輸出至預設印表機，以及透過 PrinterSettings 進行文件層級存取以實現完整的印表機控制。

透過 IronPDF，印表機通訊背後的複雜性將由該函式庫處理。 開發人員使用高階 API 進行操作，無需管理作業系統層級的 PRINT 佇列互動、subprocess 指令，或特定平台的 PRINT 工具。 這意味著相同的 Python 程式碼可在 Windows、Linux 和 macOS 上運行，無需任何修改。

一項關鍵功能是能在列印前將 HTML、CSS 和 JavaScript 轉換為 PDF —— 當原始素材是網頁範本或動態報表而非現有檔案時，此功能特別實用。如需進一步了解，請參閱 HTML 轉 PDF 教學指南。 該函式庫亦支援在 PRINT 前合併 PDF 檔案，並可壓縮 PDF 檔案，以縮短大型文件的 PRINT 排程傳輸時間。

如何安裝 IronPDF for Python？

IronPDF 套件可在 PyPI 上取得，並可透過單一 pip 指令進行安裝。

 pip install ironpdf

安裝完成後，請在腳本頂端加入以下導入語句：

from ironpdf import *

from ironpdf import *

IronPDF 需要 Python 3.6 或更高版本。 此套件在首次使用時會自動下載 IronPDF 渲染引擎，因此初次載入可能需要片刻時間。 若處於外連存取受限的環境，請參閱 IronPDF Engine 配置指南以了解離線設定選項。

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

如何載入 PDF 檔案進行列印？

使用 IronPDF for Python 將檔案系統中的 PDF 載入至 PdfDocument 物件。

IronPDF 會使用 PdfDocument.FromFile() 從檔案系統載入 PDF 檔案。 此方法接受一個檔案路徑字串，並回傳一個 PdfDocument 物件，該物件已準備好進行列印、處理或檢視。

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load from a file path
pdf = PdfDocument.FromFile("MyPdf.pdf")

# Load from bytes (e.g., a file read from a database or HTTP response)
with open("MyPdf.pdf", "rb") as f:
    pdf_bytes = f.read()
pdf_from_bytes = PdfDocument.FromBytes(pdf_bytes)

# Load a password-protected PDF
protected_pdf = PdfDocument.FromFile("SecurePdf.pdf", "password123")

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load from a file path
pdf = PdfDocument.FromFile("MyPdf.pdf")

# Load from bytes (e.g., a file read from a database or HTTP response)
with open("MyPdf.pdf", "rb") as f:
    pdf_bytes = f.read()
pdf_from_bytes = PdfDocument.FromBytes(pdf_bytes)

# Load a password-protected PDF
protected_pdf = PdfDocument.FromFile("SecurePdf.pdf", "password123")

上述程式碼展示了三種載入模式。 FromFile() 是檔案系統工作流程中最常見的選項。 FromBytes() 適用於 PDF 檔案以二進位資料形式從資料庫查詢或 API 回應中取得的情況。 FromFile() 中的可選密碼參數，可直接處理加密的 PDF 檔案，無需額外的解密步驟。

對於源自網址或 HTML 內容的 PDF 檔案，IronPDF 亦可將網址轉換為 PDF，或在列印前將 HTML 檔案渲染為 PDF。

如何使用預設設定列印 PDF？

A Python script using IronPDF's `Print()` method sends a PDF job to the system default printer.

Print() 方法會使用預設的頁面設定，將文件傳送至系統的預設印表機。 無需進行額外設定。

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load the PDF
pdf = PdfDocument.FromFile("invoice.pdf")

# Print to default printer with default settings
pdf.Print()

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load the PDF
pdf = PdfDocument.FromFile("invoice.pdf")

# Print to default printer with default settings
pdf.Print()

預設設定會使用系統設定的預設印表機、列印所有頁面、套用印表機本身的預設紙張尺寸與方向，並輸出一份副本。 若使用者的印表機設定已符合文件要求，這將是適用於簡單工作流程的理想選擇。

在實際程式碼中，請將PRINT呼叫包覆於錯誤處理程序中，以擷取印表機離線或權限錯誤：

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

try:
    pdf = PdfDocument.FromFile("invoice.pdf")
    pdf.Print()
except Exception as e:
    print(f"Print job failed: {e}")

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

try:
    pdf = PdfDocument.FromFile("invoice.pdf")
    pdf.Print()
except Exception as e:
    print(f"Print job failed: {e}")

此例外訊息提供有關列印失敗的作業系統層級詳細資訊——例如，印表機是否離線、列印排程器是否暫停，或是文件渲染失敗。

如何在列印前自訂列印設定？

IronPDF's `GetPrintDocument()` method returns a PrintDocument object with full access to PrinterSettings properties.

GetPrintDocument() 會傳回一個 PrintDocument 物件，該物件提供完整的 PrinterSettings API。 這讓您能在傳送列印工作前，選取指定印表機、設定頁碼範圍、控制複印份數與排序方式，並設定雙面列印模式。

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

pdf = PdfDocument.FromFile("quarterly-report.pdf")

# Access the PrintDocument object
printer_setting = pdf.GetPrintDocument()

# Select a specific printer by name
printer_setting.PrinterSettings.PrinterName = "HP LaserJet Pro"

# Print only pages 2 through 4
printer_setting.PrinterSettings.FromPage = 2
printer_setting.PrinterSettings.ToPage = 4

# Print 2 collated copies
printer_setting.PrinterSettings.Copies = 2
printer_setting.PrinterSettings.Collate = True

# Execute the print job
printer_setting.Print()

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

pdf = PdfDocument.FromFile("quarterly-report.pdf")

# Access the PrintDocument object
printer_setting = pdf.GetPrintDocument()

# Select a specific printer by name
printer_setting.PrinterSettings.PrinterName = "HP LaserJet Pro"

# Print only pages 2 through 4
printer_setting.PrinterSettings.FromPage = 2
printer_setting.PrinterSettings.ToPage = 4

# Print 2 collated copies
printer_setting.PrinterSettings.Copies = 2
printer_setting.PrinterSettings.Collate = True

# Execute the print job
printer_setting.Print()

PrinterSettings.PrinterName 屬性接受印表機在作業系統印表機清單中顯示的名稱。在 Windows 系統中，此名稱與"裝置和印表機"中顯示的名稱相符。 在 Linux 系統中，這對應於 CUPS 印表機名稱。 若設定無效的印表機名稱，將導致印表工作在執行時失敗，因此在建置使用者介面的印表對話方塊時，請務必根據已安裝的印表機清單驗證名稱。

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

def batch_print(file_paths):
    for path in file_paths:
        try:
            pdf = PdfDocument.FromFile(path)
            pdf.Print()
        except Exception as e:
            print(f"Failed to print {path}: {e}")

batch_print(["invoice_001.pdf", "invoice_002.pdf", "shipping_label.pdf"])

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

def batch_print(file_paths):
    for path in file_paths:
        try:
            pdf = PdfDocument.FromFile(path)
            pdf.Print()
        except Exception as e:
            print(f"Failed to print {path}: {e}")

batch_print(["invoice_001.pdf", "invoice_002.pdf", "shipping_label.pdf"])

Python PDF 列印的下一步是什麼？

本指南涵蓋了 IronPDF for Python 中的兩種核心列印模式：使用 pdf.Print() 的預設印表機輸出，以及使用 pdf.GetPrintDocument() 的自訂設定輸出。 這兩種解決方案皆可在 Windows、Linux 和 macOS 上運行，且不含任何平台專屬程式碼。

若要在生產環境的應用程式中擴展這些模式，請考慮：

• 在列印前填寫 PDF 表單，以便從範本生成已填妥的文件
• 在送印前添加浮水印或數位簽章
• 將 HTML 轉換為 PDF，以便從網頁範本進行動態報表列印
• 從列印文件中擷取文字以供稽核記錄

Start with a free trial license to test printing in your environment. 生產環境部署的授權方案起價為 $999。

下載本指南中使用的完整原始碼。