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

安装后，为生产环境配置您的许可证密钥。 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")

// 该代码片段不可用！
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文件应用批处理压缩？

处理一整文件夹的 PDF 文件时，操作流程与上述 API 相同：遍历每个 .pdf 文件，使用 PdfDocument 加载文件，调用 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}")

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}%")

// 该代码片段不可用！
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的核心功能。