Komprimieren von PDF-Dateien in Python

Was ist IronPDF und warum sollte man es für die PDF-Komprimierung verwenden?

IronPDF ist eine Python-PDF-Bibliothek, die die Erstellung, das Lesen, die Bearbeitung und die Optimierung von PDF-Dokumenten behandelt. Es arbeitet mit Dateien, die von Grund auf neu erstellt, von HTML konvertiert oder von der Festplatte geladen wurden. Seine Kompressions-API zielt auf Bilder ab, die Hauptverursacher für große PDF-Größen sind.

Die Methode CompressImages akzeptiert einen Qualitätswert zwischen 1 und 100 sowie einen optionalen booleschen Wert, der Bilder auf ihre sichtbare Auflösung verkleinert. Dieses Design mit zwei Parametern ermöglicht Ihnen eine präzise Kompression: Ein hochfrequentiertes Berichterstattungs-Dashboard könnte Qualität 70 verwenden, um Grafiken scharf zu halten, während ein internes Archivierungssystem möglicherweise Qualität 40 verwendet, um maximale Speicherplatzersparnis zu erzielen. Die Bibliothek bearbeitet alle Kodierungen intern, sodass keine zusätzlichen Abhängigkeiten erforderlich sind.

IronPDF ist Teil der Iron Suite, die Dokumentenerstellung, Barcode-Verarbeitung, OCR und ZIP-Archivierung umfasst, alles aus einer gemeinsamen Python-Installation. Für Entwickler, die IronPDF bereits verwenden, um PDFs von Grund auf neu zu erstellen, ist die Kompression ein natürlicher Schritt, bevor Dateien gespeichert oder verteilt werden.

Wie installiert man IronPDF in Python?

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

// DIESE CODE-AUSZUG IST NICHT VERFÜGBAR!
:ProductInstall

Nach der Installation konfigurieren Sie Ihren Lizenzschlüssel für Produktionsumgebungen. IronPDF enthält eine kostenlose 30-Tage-Testversion, die alle Funktionen abdeckt, einschließlich Kompression, ohne dass eine Kreditkarte erforderlich ist. Die PyPI-Paketseite listet die neuesten Release-Hinweise und Abhängigkeitsdetails auf.

Wie komprimiert man PDF-Dateien mit IronPDF?

Übergeben Sie einen Qualitätswert an CompressImages, um die Größe der eingebetteten Bilder im gesamten Dokument zu reduzieren. Niedrigere Ganzzahlen erzeugen kleinere Dateien auf Kosten der Bildqualität; höhere Ganzzahlen erhalten mehr Details. Das folgende Beispiel zeigt sowohl einen Standardkompressionsaufruf als auch einen erweiterten Aufruf, der Bilder auf ihre sichtbare Größe herunterskalieren kann.

: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")

// DIESE CODE-AUSZUG IST NICHT VERFÜGBAR!
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")

Wie wendet man Batch-Kompression auf mehrere PDF-Dateien an?

Die Verarbeitung eines Ordners mit PDF-Dateien erfolgt über dieselbe API: Durchlaufen Sie jede .pdf-Datei, laden Sie sie mit PdfDocument, rufen Sie CompressImages auf und speichern Sie das Ergebnis. Die folgende Funktion fasst dieses Muster zu einem wiederverwendbaren Hilfsprogramm zusammen.

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

// DIESE CODE-AUSZUG IST NICHT VERFÜGBAR!
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}")

Der Block except verhindert, dass eine einzelne beschädigte oder passwortgeschützte Datei den gesamten Stapelvorgang zum Stillstand bringt. Das Protokollieren des Dateinamens zusammen mit der Fehlermeldung erleichtert es, festzustellen, welche Dateien einer manuellen Überprüfung bedürfen. Für Pipelines mit höherem Volumen sollten Sie in Betracht ziehen, den Ordner in Abschnitte zu unterteilen und diese in parallelen Threads zu verarbeiten.

Welche Qualitätseinstellungen sollten Sie für die PDF-Kompression verwenden?

Die richtige Qualitätseinstellung hängt davon ab, wie das PDF nach der Kompression verwendet wird. Drei Bereiche decken die häufigsten Szenarien ab.

Hohe Qualität (70–90): Dokumente, die für Druck oder formale Verbreitung bestimmt sind, profitieren davon, in diesem Bereich zu bleiben. Text bleibt scharf, und Diagramme bleiben bei Standarddruckauflösungen lesbar. Die Dateigrößenreduktion ist bescheiden, typischerweise 10–25%, aber das Ausgabeergebnis ist für die meisten Leser vom Original kaum zu unterscheiden.

Mittlere Qualität (50–70): Dieser Bereich eignet sich für die Web-Auslieferung und E-Mail-Anhänge. Fotografische Inhalte zeigen bei genauer Betrachtung ein leichtes Erweichen, aber die Reduktion der Dateigröße (oft 25–50%) verbessert maßgeblich die Ladezeiten und die E-Mail-Zustellbarkeit. Die meisten Dokumentenmanagementsysteme und Portal-Uploads funktionieren gut bei Qualität 60.

Aggressive Kompression (30–50): Interne Archive, Langzeitsicherungen und Dokumente, die nicht gedruckt werden müssen, können diesen Bereich nutzen. Bei Qualität 40 sind Bilder merklich weicher, aber Text, der von der PDF-Engine gerendert wird (anstatt als Bilder eingebettet zu sein), bleibt vollständig scharf. Dieser Ansatz eignet sich auch für Dokumente, die in Bilder konvertiert und vor dem Anzeigen skaliert werden.

Wie überprüft man Kompressionsergebnisse in Python?

Die programmgesteuerte Überprüfung der Dateigröße bestätigt, dass die Komprimierung Ihr Ziel erreicht hat, bevor die Datei zum nächsten Schritt in einer Pipeline weitergeleitet wird. Pythons integrierte Funktion os.path.getsize gibt die Byteanzahl für jeden Dateipfad zurück, sodass für die Überprüfung keine zusätzlichen Bibliotheken erforderlich sind.

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

// DIESE CODE-AUSZUG IST NICHT VERFÜGBAR!
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}%")

Das Ergebnis gibt einen klaren Reduzierungsprozentwert an, den man protokollieren oder gegen einen Schwellenwert überprüfen kann. Wenn die Reduzierung unter den Erwartungen bleibt, enthält das Dokument möglicherweise nur wenige oder gar keine eingebetteten Bilder. In diesem Fall bleibt die Dateigröße unabhängig von der Qualitätseinstellung weitgehend unverändert, da CompressImages nur Rasterbilder betrifft. Text und Vektorgrafiken sind von dieser Methode nicht betroffen.

Was sind die nächsten Schritte für die PDF-Komprimierung in Python?

Die CompressImages-Methode von IronPDF bietet Python-Entwicklern eine einzige, klar abgegrenzte API zur Reduzierung der Dateigröße von PDF-Dateien. Passen Sie den Qualitätsparameter an, um die Speichereinsparungen gegen die visuelle Wiedergabetreue abzuwägen, und fügen Sie den Boolean zur Auflösungsskalierung für eine zweite Reduktionsrunde hinzu, wenn die Ausgabeabmessungen festgelegt sind. Für einen umfassenderen Überblick darüber, was IronPDF behandeln kann, lesen Sie die Seite Python PDF library overview.

Starten Sie Ihre kostenlose Testversion, um die Kompression zusammen mit dem vollen Funktionsumfang von IronPDF zu testen, einschließlich HTML-zu-PDF-Konvertierung, digitaler Signaturen, Formularverarbeitung und Dokumentenzusammenführung. Wenn die Testphase endet, sehen Sie sich die Lizenzierungsoptionen an, um den Plan zu finden, der zu Ihrer Bereitstellung passt.

Bereit zu sehen, was IronPDF sonst noch kann? Erkunden Sie das vollständige Python PDF-Tutorial für eine schrittweise Einführung in die Kernfunktionen von IronPDF.