Jak kompresować pliki PDF w języku Python

Czym jest IronPDF i dlaczego warto go używać do kompresji plików PDF?

IronPDF jest biblioteką PDF dla Pythona, która obsługuje tworzenie, czytanie, edytowanie i optymalizację dokumentów PDF. Działa z plikami tworzonymi od zera, konwertowanymi z HTML lub ładowanymi z dysku. Jej API kompresji jest skierowane do obrazów, które są głównym czynnikiem przyczyniającym się do dużych rozmiarów PDF.

Metoda CompressImages akceptuje liczbę jakości od 1 do 100 oraz opcjonalny parametr bool, który skaluje obrazy do ich widocznej rozdzielczości. Ten projekt z dwoma parametrami pozwala precyzyjnie dostroić kompresję: tablica kontrolna o dużym obciążeniu ruchem mogłaby używać jakości 70, aby zachować ostre wizualizacje, podczas gdy system archiwizacji wewnętrznej mógłby używać jakości 40, aby maksymalizować oszczędności w przechowywaniu. Biblioteka obsługuje wszystkie wewnętrzne kody, więc nie są wymagane dodatkowe zależności.

IronPDF jest częścią Iron Suite, który obejmuje tworzenie dokumentów, przetwarzanie kodów kreskowych, OCR i archiwizację ZIP, wszystko z jednoczesnego instalowania Pythona. Dla deweloperów już używających IronPDF do tworzenia PDF-ów od zera, kompresja jest naturalnym kolejnym krokiem przed zapisaniem lub udostępnieniem plików.

Jak zainstalować IronPDF w Pythonie?

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

// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
:ProductInstall

(

Po instalacji skonfiguruj swój klucz licencyjny dla środowisk produkcyjnych. IronPDF obejmuje bezpłatny 30-dniowy okres próbny, który obejmuje wszystkie funkcje, w tym kompresję, bez wymagania podania karty kredytowej. Strona pakietu PyPI zawiera najnowsze informacje o wersjach oraz szczegóły dotyczące zależności.

Jak skompresować pliki PDF używając IronPDF?

Przekaż liczbę jakości do CompressImages, aby zmniejszyć rozmiar osadzonych obrazów w całym dokumencie. Niższe liczby całkowite skutkują mniejszymi plikami kosztem wierności obrazu; wyższe liczby całkowite zachowują więcej szczegółów. Poniższy przykład pokazuje zarówno standardowe wywołanie kompresji, jak i zaawansowane wywołanie, które dodatkowo zmniejsza rozmiar obrazów do ich widocznego rozmiaru.

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

Jak wygląda plik PDF po kompresji?

Porównanie pokazuje redukcję z 458 KB do 357 KB (około 22%) przy użyciu jakości 60. Pliki z większym udziałem zawartości fotograficznej zazwyczaj osiągają większe redukcje niż pliki zdominowane przez tekst lub grafikę wektorową.

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak zastosować kompresję wsadową do wielu plików PDF?

Przetwarzanie folderu plików PDF odbywa się za pomocą tego samego API: iteruj po każdym pliku .pdf, załaduj go za pomocą PdfDocument, wywołaj CompressImages i zapisz wynik. Funkcja poniżej opakowuje ten wzorzec w narzędzie wielokrotnego użytku.

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

// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
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}")

Blok except zapobiega zatrzymaniu całej partii przez pojedynczy uszkodzony lub hasłem zabezpieczony plik. Logowanie nazwy pliku wraz z komunikatem o wyjątku ułatwia identyfikację, które pliki wymagają ręcznej weryfikacji. Dla wyższych przepustowości, rozważ podział folderu na części i przetwarzanie ich w równoległych wątkach.

Jakie ustawienia jakości powinieneś użyć do kompresji PDF?

Odpowiednie ustawienie jakości zależy od tego, jak PDF będzie używany po kompresji. Trzy zakresy pokrywają najczęstsze scenariusze.

Wysoka jakość (70–90): Dokumenty przeznaczone do drukowania lub formalnej dystrybucji korzystają z pozostania w tym zakresie. Tekst pozostaje ostry, a diagramy pozostają czytelne przy standardowych rozdzielczościach wydruku. Redukcja rozmiaru pliku jest skromna, zazwyczaj 10–25%, ale wynik jest nie do odróżnienia od źródła dla większości czytelników.

Średnia jakość (50–70): Ten zakres pasuje do dostarczania przez sieć i załączników e-mail. Treść fotograficzna pokazuje niewielkie zmiękczenie przy bliższym przyjrzeniu, ale zmniejszenie rozmiaru pliku (często 25–50%) znacząco poprawia czasy ładowania i dostarczalność e-maili. Większość systemów zarządzania dokumentami i przesyłanie do portalu działa dobrze przy jakości 60.

Aggresywna kompresja (30–50): Wewnętrzne archiwa, długoterminowe kopie zapasowe i dokumenty, które nie będą drukowane, mogą korzystać z tego zakresu. Przy jakości 40 obrazy są wyraźnie bardziej miękkie, ale tekst renderowany przez silnik PDF (a nie osadzony jako obrazy) pozostaje w pełni ostry. To podejście jest również odpowiednie dla dokumentów, które będą konwertowane na obrazy i zmieniane przed wyświetleniem.

Jak zweryfikować wyniki kompresji w Pythonie?

Sprawdzenie rozmiaru pliku wyjściowego programowo potwierdza, że kompresja spełniła Twój cel przed przeniesieniem pliku do następnego etapu w tłoków audio. Wbudowana funkcja Pythona os.path.getsize zwraca liczbę bajtów dla dowolnej ścieżki pliku, więc weryfikacja nie wymaga dodatkowych bibliotek.

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

Wynik daje jasny procent redukcji, który można zalogować lub sprawdzić względem progu. Jeśli redukcja jest poniżej oczekiwań, dokument może zawierać mało lub brak osadzonych obrazów. W takim przypadku rozmiar pliku pozostanie w dużej mierze niezmieniony, bez względu na ustawienie jakości, ponieważ CompressImages jest skierowane tylko na obrazy rastrowe. Tekst i grafika wektorowa nie są dotknięte tą metodą.

Jakie są kolejne kroki kompresji PDF w Pythonie?

Metoda CompressImages IronPDF daje programistom Pythona jedno, dobrze zdefiniowane API do zmniejszania rozmiarów plików PDF. Dostosuj parametr jakości, aby zrównoważyć oszczędności przechowywania z wiernością wizualną, i dodaj bool do skalowania rozdzielczości dla drugiego etapu redukcji, gdy wymiary wyjściowe są ustalone. Dla szerszego spojrzenia na to, co obsługuje IronPDF, zobacz przegląd biblioteki PDF w Pythonie.

Rozpocznij swoją darmową wersję próbną, aby przetestować kompresję razem z pełnym zestawem funkcji IronPDF, w tym konwersją z HTML na PDF, podpisami cyfrowymi, obsługą formularzy i scalaniem dokumentów. Gdy okres próbny się skończy, zobacz opcje licencjonowania, aby znaleźć plan odpowiadający Twojemu wdrożeniu.

Gotowy, aby zobaczyć, co jeszcze potrafi IronPDF? Odkryj pełny samouczek PDF w Pythonie, aby krok po kroku poznać podstawowe możliwości IronPDF.