如何使用 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

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

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-print-pdf-3.py

from ironpdf import *

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

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-print-pdf-4.py

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

如何加载PDF文件以进行打印？

使用IronPDF for Python，将PDF从文件系统加载到PdfDocument对象。

IronPDF使用PdfDocument.FromFile()从文件系统加载PDF文件。 该方法接受文件路径字符串并返回一个PdfDocument对象，准备打印、操作或检查。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-print-pdf-5.py

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文件，IronPDF还可以从图像、HTML字符串和实时URL生成可打印的文档。 这在打印工作流中很有用，当源数据还不是PDF时，例如，首先将包含图表的报表模板渲染为PDF，然后再发送到打印机。

---

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

Iron Suite 在我们的运营中起着至关重要的作用。这些工具提高了业务各方面的效率，包括创建平面图和改善库存管理。

David Jones

首席软件工程师，Agorus Build

查看案例研究

如何使用默认设置打印PDF？

使用IronPDF的`Print()`方法的Python脚本将PDF作业发送到系统默认打印机。

Print()方法使用默认页面设置将文档发送到系统的默认打印机。 无需额外配置。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-print-pdf-6.py

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()

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

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

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-print-pdf-7.py

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的`GetPrintDocument()`方法返回一个PrintDocument对象，具有对PrinterSettings属性的完全访问权限。

PrinterSettings API。 这允许在发送作业之前选择命名打印机、设置页面范围、控制副本和整理以及配置双面模式。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-print-pdf-8.py

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打印机名称。 设置无效的打印机名称将导致打印作业在运行时失败，因此在构建面向用户的打印对话框时请根据已安装的打印机列表验证名称。

[System.Drawing.Printing.PrinterSettings]::InstalledPrinters，或使用pywin32的Python win32print模块以编程方式枚举打印机。

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.GetPrintDocument()的自定义设置输出。 这两种方法在Windows、Linux和macOS上都可以工作，不需要特定的平台代码。

在生产应用程序中扩展这些模式时请考虑：

• 在打印前填写PDF表单以从模板生成完整的文档
• 在发送到打印机之前添加水印或数字签名
• 将HTML转换为PDF以便从Web模板进行动态报表打印
• 从打印的文档中提取文本进行审计日志记录

从免费试用许可证开始，以在您的环境中测试打印。 许可选项从$999开始用于生产部署。

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