如何用 Python 压缩 PDF 文件

什么是 IronPDF，为什么使用它进行 PDF 压缩？

IronPDF是一个Python PDF库，处理PDF文档的创建、阅读、编辑和优化。 它适用于从头开始生成的文件，从HTML转换的文件，或从磁盘加载的文件。 其压缩API主要针对的是图像，这是大PDF尺寸的主要原因。

CompressImages方法接受一个1到100的质量整数和一个可选的布尔值，该布尔值将图像缩小到其可见分辨率。 这种双参数设计让您可以精确地调整压缩：高流量报告仪表板可能使用质量70以保持视觉清晰，而内部档案系统可能使用质量40以实现最大存储节省。 库处理所有内部编码，因此无需附加依赖。

IronPDF是Iron Suite的一部分，涵盖文档创建、条码处理、OCR和ZIP归档，全部来自共享的Python安装。 对于已经使用IronPDF从头创建PDF的开发人员，压缩在保存或分发文件之前作为自然的后续步骤。

如何在Python中安装IronPDF？

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/install.sh
:ProductInstall

:ProductInstall

:ProductInstall

安装后，为生产环境配置您的许可证密钥。 IronPDF包含一个免费的30天试用，涵盖所有功能，包括压缩，无需信用卡。 PyPI包页面列出了最新发布说明和依赖详细信息。

如何使用IronPDF压缩PDF文件？

通过给CompressImages传递一个质量整数以减小整个文档中嵌入图像的大小。 较低的整数会产生较小的文件，但会降低图像保真度； 较高的整数保留更多细节。 下面的示例展示了标准压缩调用和一个高级调用，该调用还将图片缩小到其可见尺寸。

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

from ironpdf import PdfDocument

# Load the PDF document from a file
pdf = PdfDocument("Image based PDF.pdf")

# Compress images to quality 60 (lower numbers increase compression)
pdf.CompressImages(60)
pdf.SaveAs("document_compressed.pdf")

# Advanced: also scale images down to their visible size in the PDF
# Note: scaling can affect image clarity if pages are resized later
pdf.CompressImages(90, True)
pdf.SaveAs("Compressed.pdf")

压缩后的 PDF 如何显示？

比较显示使用质量60从458 KB减少到357 KB（大约22%）。含较多摄影内容的文件通常比以文本或矢量图形为主的文件减小得更多。

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

Milan Jovanovic

微软MVP

查看案例研究

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

Brent Matzelle

首席技术官，OPYN

查看案例研究

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

David Jones

首席软件工程师，Agorus Build

查看案例研究

如何对多个PDF文件应用批处理压缩？

处理一个PDF文件夹遵循相同的API：遍历每个CompressImages，并保存结果。 下面的函数将此模式封装成可重用的工具。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/batch-compress.py
import os
from ironpdf import PdfDocument

def batch_compress_pdfs(input_folder, output_folder, quality=60):
    """
    Compress all PDF files in a folder.

    Args:
        input_folder: Path to folder containing source PDFs
        output_folder: Path where compressed PDFs will be saved
        quality: Compression quality (1–100); default is 60
    """
    # Create the output folder if it does not exist
    os.makedirs(output_folder, exist_ok=True)

    for filename in os.listdir(input_folder):
        if filename.endswith(".pdf"):
            input_path = os.path.join(input_folder, filename)
            output_path = os.path.join(output_folder, f"compressed_{filename}")

            try:
                pdf = PdfDocument(input_path)
                pdf.CompressImages(quality)
                pdf.SaveAs(output_path)
                print(f"Compressed: {filename}")
            except Exception as e:
                print(f"Error compressing {filename}: {e}")

import os
from ironpdf import PdfDocument

def batch_compress_pdfs(input_folder, output_folder, quality=60):
    """
    Compress all PDF files in a folder.

    Args:
        input_folder: Path to folder containing source PDFs
        output_folder: Path where compressed PDFs will be saved
        quality: Compression quality (1–100); default is 60
    """
    # Create the output folder if it does not exist
    os.makedirs(output_folder, exist_ok=True)

    for filename in os.listdir(input_folder):
        if filename.endswith(".pdf"):
            input_path = os.path.join(input_folder, filename)
            output_path = os.path.join(output_folder, f"compressed_{filename}")

            try:
                pdf = PdfDocument(input_path)
                pdf.CompressImages(quality)
                pdf.SaveAs(output_path)
                print(f"Compressed: {filename}")
            except Exception as e:
                print(f"Error compressing {filename}: {e}")

import os
from ironpdf import PdfDocument

def batch_compress_pdfs(input_folder, output_folder, quality=60):
    """
    Compress all PDF files in a folder.

    Args:
        input_folder: Path to folder containing source PDFs
        output_folder: Path where compressed PDFs will be saved
        quality: Compression quality (1–100); default is 60
    """
    # Create the output folder if it does not exist
    os.makedirs(output_folder, exist_ok=True)

    for filename in os.listdir(input_folder):
        if filename.endswith(".pdf"):
            input_path = os.path.join(input_folder, filename)
            output_path = os.path.join(output_folder, f"compressed_{filename}")

            try:
                pdf = PdfDocument(input_path)
                pdf.CompressImages(quality)
                pdf.SaveAs(output_path)
                print(f"Compressed: {filename}")
            except Exception as e:
                print(f"Error compressing {filename}: {e}")

except块会阻止单个损坏或有密码保护的文件停止整个批处理。 将文件名与异常消息一起记录可以更容易地识别哪些文件需要人工审核。 对于高产量流水线，考虑将文件夹拆分成块，并在并行线程中处理。

PDF压缩应该使用哪些质量设置？

正确的质量设置取决于PDF在压缩后将如何使用。 三个范围涵盖最常见场景。

高质量（70-90）：旨在打印或正式分发的文件受益于保持在此范围内。 文本保持清晰，图表在标准打印分辨率下可读。 文件大小缩减通常为10-25%，但对于大多数读者来说，输出与来源没有区别。

中等质量（50-70）：适合网页传输和电子邮件附件。 摄影视内容在仔细检查时略显柔和，但文件大小的缩减（通常为25-50%）显著提高了加载时间和电子邮件的可交付性。 大多数文档管理系统和门户上传在质量60时效果良好。

强力压缩（30-50）：内部档案、长期存储备份和不会打印的文件可以使用此范围。 在质量40时，图像明显较柔和，但由PDF引擎渲染的文本（而非嵌入为图像的文本）仍然完全清晰。这种方法也适用于将被转换为图像并在显示前缩放的文件。

如何在Python中验证压缩结果？

通过编程方式检查输出文件大小之前，确认压缩达到了你的目标，然后文件进入管道的下一步。Python的内置os.path.getsize可以返回任何文件路径的字节数，因此验证不需要额外的库。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/verify-compression.py

import os
from ironpdf import PdfDocument

# Load and compress the document
pdf = PdfDocument("report.pdf")
original_size = os.path.getsize("report.pdf")

pdf.CompressImages(60)
pdf.SaveAs("report_compressed.pdf")

compressed_size = os.path.getsize("report_compressed.pdf")
reduction_pct = (1 - compressed_size / original_size) * 100

# Report results to confirm compression was effective
print(f"Original:   {original_size / 1024:.1f} KB")
print(f"Compressed: {compressed_size / 1024:.1f} KB")
print(f"Reduction:  {reduction_pct:.1f}%")

输出提供了一个可以记录或与阈值比较的清晰减小比例。 如果减少比例低于预期，该文档可能几乎没有嵌入图像或没有嵌入图像。 在这种情况下，不管质量设置如何，文件大小将基本保持不变，因为CompressImages仅针对栅格图像。 此方法不影响文本和矢量图形。

Python中的PDF压缩下一步是什么？

IronPDF的CompressImages方法为Python开发者提供了一个单一、明确作用域的API来减少PDF文件的大小。 调整质量参数以在存储节省与视觉保真度之间取得平衡，并添加分辨率缩减布尔值，以便在输出尺寸固定时进行第二次缩减。 想全面了解IronPDF的处理能力，请查看Python PDF库概述页面。

开始您的免费试用，同时测试IronPDF的全功能套件，包括HTML到PDF转换、数字签名、表单处理和文档合并。 试用期结束时，查看许可选项以找到适合您部署的计划。

准备看看IronPDF还能做些什么吗？ 探索完整的Python PDF教程，了解IronPDF的核心功能。