如何使用 Python 打印 PDF 文件

什么是IronPDF以及它如何帮助PDF打印？

IronPDF 是一个 Python 库，使开发人员能够生成、操作和转换 PDF 文档。 该库的打印支持涵盖两种模式：通过单次方法调用直接输出至默认打印机，以及通过 PrinterSettings 进行文档级访问以实现对打印机的完全控制。

使用IronPDF，打印机通信的底层复杂性由库处理。 开发者使用的是高级 API，无需管理操作系统级别的打印队列交互、subprocess 命令或特定平台的打印工具。 这意味着相同的Python代码在Windows、Linux和macOS上都可以无需修改运行。

其关键功能是将HTML、CSS和JavaScript转换为PDF再进行打印——当源材料是Web模板或动态报告而不是现有文件时很有用。有关更多信息，请参阅HTML到PDF教程。 该库还支持在打印前合并PDF和压缩PDF，以减少大型文档的后台传输时间。

如何安装IronPDF for Python？

IronPDF包在PyPI上可用，并且只需一个pip命令即可安装。

 pip install ironpdf

安装后，在脚本顶部添加导入语句：

from ironpdf import *

from ironpdf import *

IronPDF需要Python 3.6或更高版本。 该包在首次使用时自动下载IronPDF渲染引擎，因此初次导入可能需要一些时间。 对于限制出站访问的环境，请参阅IronPDF引擎配置指南以获取离线设置选项。

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 对象，该对象可用于 PRINT、操作或检查。

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 文件，无需任何额外的解密步骤。

对于来源于URL或HTML内容的PDF，IronPDF还可以将URL转换为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()

默认设置使用系统配置的默认打印机，打印所有页面，应用打印机自身的默认纸张大小和方向，并发送一份副本。 这对于用户的打印机配置已经符合文档要求的简单工作流来说是正确的选择。

对于生产代码，将打印调用包装在错误处理中，以捕获打印机离线或权限错误：

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以便从Web模板进行动态报表打印
• 从打印的文档中提取文本进行审计日志记录

Start with a free trial license to test printing in your environment. 生产环境部署的许可方案起价为 $999。

下载本指南使用的完整源代码。