如何在 Java 中压缩 PDF 文件

IronPDF 使 Java 开发人员能够通过降低图像质量和缩放分辨率来压缩 PDF 文件，从而帮助减小文件大小，方便共享和存储。

快速开始：在Java中压缩PDF文件

```java {title="在Java中压缩PDF"} //:path=/static-assets/pdf/content-code-examples/java/how-to/compress-pdf-java-tutorial/quickstart-compress.java import com.ironsoftware.IronPDF.*； 导入 java.nio.file.Paths；

// 加载您的 PDF 文档 PdfDocument pdf = PdfDocument.fromFile(Paths.get("source.pdf"))；

// 将图像压缩至 60% 的质量 pdf.compressImages(60)；

// 保存压缩 PDF pdf.saveAs(Paths.get("compressed.pdf"))；

<div class="hsg-featured-snippet">
<h3>最小工作流程（5 个步骤）</h3>

1. 将IronPDF作为依赖添加到您的Maven `pom.xml`
2. 使用`PdfDocument.fromFile()`加载您的PDF
3. 使用`pdf.compressImages(60)`压缩图像
4. 可选使用`pdf.compressImages(90, true)`缩放图像分辨率
5. 使用`pdf.saveAs()`保存压缩的PDF
</div>

PDF文档广泛用于共享和存储信息，但图像较多的文件很快就会达到数十兆字节。 大文件大小会使电子邮件传递复杂化，上传速度变慢，并增加存储成本。 IronPDF的Java压缩API通过让您在代码中用几行代码降低嵌入图像的质量和缩放分辨率来解决此问题。

本文将介绍如何在Java中使用IronPDF压缩PDF文件。 示例展示了简单的基于质量的压缩和分辨率缩放，因此您可以根据具体的尺寸和质量要求选择适合的方法。 如果您还在处理[图像较多的PDF](https://ironpdf.com/java/how-to/java-pdf-to-image-tutorial/)或需要处理[合并的文档](https://ironpdf.com/java/how-to/java-merge-pdf-tutorial/)，压缩是分发前的一个重要步骤。

## 什么是IronPDF Java PDF库？

IronPDF是一个[Java PDF库](/java/)，可通过编程方式创建、读取和操作PDF文档。 该库处理[HTML到PDF的转换](https://ironpdf.com/java/tutorials/html-to-pdf/)、表单填写、图像嵌入和文件压缩，而无需PDF查看器或外部渲染引擎。它支持多种部署环境，包括[AWS Lambda](https://ironpdf.com/java/get-started/aws/)、[Azure Functions](https://ironpdf.com/java/get-started/azure/) 和 [Google Cloud](https://ironpdf.com/java/get-started/google-cloud/)。

IronPDF中的压缩通过重新采样嵌入的图像到较低的JPEG质量水平来实现，并且可选地将其分辨率降低到PDF中的显示大小。 文本、矢量图形和文档结构不受影响。 这使得IronPDF成为需要快速通过电子邮件传输或存储在云系统中的大量文件的实用选择。

该库还可以很好地与其他文档操作一起工作：您可以压缩已经有[水印](https://ironpdf.com/java/how-to/custom-watermark/)、[背景层](https://ironpdf.com/java/how-to/background-foreground/)和[书签](https://ironpdf.com/java/how-to/bookmarks/)的PDF，且所有这些功能在压缩后都能保留。

请注意压缩对包含嵌入JPEG或PNG图像的PDF最为有效。 主要由文本和矢量图形组成的文档将看到最小的尺寸减少。

## 如何在Java Maven项目中设置IronPDF？

在压缩PDF之前，将IronPDF添加到您的项目的Maven配置中。 有关完整设置说明，请参阅[快速入门指南](https://ironpdf.com/java/docs/)。

- 要在[Maven项目](/java/docs/)中安装IronPDF，请将`IronPDF` Maven仓库和依赖添加到您的`pom.xml`文件中。

- 将依赖添加到`<dependencies>`部分：

    ```xml
    //:path=/static-assets/pdf/content-code-examples/java/how-to/compress-pdf-java-tutorial/maven-dependency.xml
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>your_version_here</version>
    </dependency>

• 保存您的IronPDF依赖。

一旦依赖解决，您可以在项目中导入和使用IronPDF类。 最新发布的IronPDF Java工件版本可在Maven Central获得。 为了生产部署，在运行前配置您的许可证密钥。

如何在Java中压缩PDF文件？

IronPDF通过定位嵌入在文档中的图像来压缩PDF文件。 compressImages()方法接受一个从0到100的整数作为质量，其中较低的值会产生较小的文件，但会牺牲图像清晰度。 可选的第二个参数指示库根据PDF页面中的显示大小缩小图像分辨率。

//:path=/static-assets/pdf/content-code-examples/java/how-to/compress-pdf-java-tutorial/compress-pdf-images.java
import com.ironsoftware.IronPDF.*；
import java.io.IOException;
导入 java.nio.file.Paths；

public class App {
    public static void main(String[] args) throws IOException {
        // Load the source PDF from disk
        String src = "C:\\Image based PDF.pdf";
        PdfDocument pdf = PdfDocument.fromFile(Paths.get(src));

        // First pass: compress images to 60% quality
        // Lower values produce smaller files with more visible quality loss
        pdf.compressImages(60)；
        pdf.saveAs(Paths.get("assets/document_compressed.pdf"));

        // Second pass (optional): compress to 90% quality with resolution scaling
        // The second parameter scales image resolution down to match display size,
        // which can reduce file size further but may cause distortion in some PDFs
        pdf.compressImages(90, true);
        pdf.saveAs(Paths.get("C:\\Compressed.pdf"));
    }
}

//:path=/static-assets/pdf/content-code-examples/java/how-to/compress-pdf-java-tutorial/compress-pdf-images.java
import com.ironsoftware.IronPDF.*；
import java.io.IOException;
导入 java.nio.file.Paths；

public class App {
    public static void main(String[] args) throws IOException {
        // Load the source PDF from disk
        String src = "C:\\Image based PDF.pdf";
        PdfDocument pdf = PdfDocument.fromFile(Paths.get(src));

        // First pass: compress images to 60% quality
        // Lower values produce smaller files with more visible quality loss
        pdf.compressImages(60)；
        pdf.saveAs(Paths.get("assets/document_compressed.pdf"));

        // Second pass (optional): compress to 90% quality with resolution scaling
        // The second parameter scales image resolution down to match display size,
        // which can reduce file size further but may cause distortion in some PDFs
        pdf.compressImages(90, true);
        pdf.saveAs(Paths.get("C:\\Compressed.pdf"));
    }
}

JAVA

代码从磁盘加载PDF，并通过两个过程应用压缩以说明不同的策略。 第一个compressImages(60)调用将图像质量降低到60%并保存结果。 第二次调用使用90%质量但启用了分辨率缩放，这会调整每个图像的像素尺寸，使其与页面上的可见区域相匹配。

compressImages()方法有两个签名：

• compressImages(int quality) — 将所有嵌入图像的重新采样到给定的JPEG质量水平。 使用40到80之间的值以强力减少大小，同时保持图像可识别性。
• compressImages(int quality, boolean scaleImageResolutionToVisibleSize) — 添加分辨率缩放。 当true时，库将检测以其原生分辨率一部分呈现出来的图像并相应地将其缩小。 此选项提供最激进的尺寸减小，但稍微增加处理时间。

提示应用多次迭代以微调大小和质量的平衡。 从70%的中等设置开始，检查输出文件大小，然后决定是否需要第二次以较低质量的迭代。

在图像较多的PDF上运行60%的压缩过程通常会根据源图像减少文件大小50-70%。 主要为文本内容的文档将看到更小的增益。 在输出目录中比较压缩前后的文件大小，以评估您具体文档的结果。

对于需要在压缩同时进行其他处理的文档，IronPDF支持提取文本，提取图像，和拆分PDF。

原始 PDF 看起来像什么？

压缩后的结果如何？

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

Milan Jovanovic

微软MVP

查看案例研究

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

Brent Matzelle

首席技术官，OPYN

查看案例研究

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

David Jones

首席软件工程师，Agorus Build

查看案例研究