在处理 PDF 文件时，我们常会遇到页面方向不正确的问题。例如扫描文档可能是横向或倒置，导致阅读或打印不便。在 Java 中，我们可以通过程序化方式旋转 PDF 页面，从而避免手动操作，提高处理效率。本文将讲解如何在 Java 中旋转 PDF 页面，并提供完整示例，包括单页旋转、批量旋转以及动态旋转。

为什么要旋转 PDF 页面

在实际工作中，PDF 页面旋转的需求主要包括：

纠正扫描文档方向有些扫描 PDF 可能是倒置或横向，需要旋转以便正确阅读或打印。打印优化打印机默认可能按照 PDF 原始方向打印，旋转页面可以确保内容正确打印。批量处理在企业或自动化流程中，手动处理大量 PDF 文档效率低下。程序化旋转可以节省大量时间。统一文档格式报告、合同或作业等文档可能需要统一页面方向，保证专业排版。

通过程序化旋转 PDF 页面，可以提高效率，并确保多份文档方向一致。

Java 旋转 PDF 页面前的准备工作

开始编程之前，需要准备以下条件：

Java 开发环境（JDK 8 或以上）PDF 处理库：本文示例使用 Spire.PDF for Java，提供了便捷的 API 来操作 PDF，包括页面旋转、合并、拆分、加密等功能。可以通过 Maven 或直接引入 jar 包使用。

Maven 依赖示例：

<repositories> <repository> <id>com.e-iceblue</id> <name>e-iceblue</name> <url>https://repo.e-iceblue.cn/repository/maven-public/</url> </repository></repositories><dependencies> <dependency> <groupId>e-iceblue</groupId> <artifactId>spire.pdf</artifactId> <version>11.12.16</version> </dependency></dependencies>

环境准备好后，即可开始旋转 PDF 页面。

Java 中 PDF 页面旋转角度说明

在 Spire.PDF 中，页面旋转通过枚举表示：

枚举值旋转角度：

Rotate_Angle_0：0°Rotate_Angle_90：90°Rotate_Angle_180：180°Rotate_Angle_270：270°

说明：

旋转为顺时针方向最终角度 = 原始角度 + 新增旋转角度旋转只改变页面方向，不改变内容坐标

了解这些枚举可以帮助精确控制页面方向。

Java 单页 PDF 页面旋转示例

有时你只需旋转 PDF 的单页，例如第一页。下面示例演示如何将第一页顺时针旋转 180°：

import com.spire.pdf.PdfDocument;import com.spire.pdf.PdfPageBase;import com.spire.pdf.PdfPageRotateAngle;public class RotatePdfPage { public static void main(String[] args) { PdfDocument pdf = new PdfDocument(); pdf.loadFromFile("Sample.pdf"); PdfPageBase page = pdf.getPages().get(0); int rotation = page.getRotation().getValue(); rotation += PdfPageRotateAngle.Rotate_Angle_180.getValue(); page.setRotation(PdfPageRotateAngle.fromValue(rotation)); pdf.saveToFile("Rotate.pdf"); System.out.println("第一页旋转完成！"); }}

说明：代码加载 PDF，获取第一页，将旋转角度加 180°，并保存为新 PDF 文件。

Java 批量旋转 PDF 所有页面示例

在许多情况下，需要旋转 PDF 的所有页面，例如批量处理扫描报告。下面示例展示如何将每页顺时针旋转 90°：

for (int i = 0; i < pdf.getPages().getCount(); i++) { PdfPageBase page = pdf.getPages().get(i); int rotation = page.getRotation().getValue(); rotation += PdfPageRotateAngle.Rotate_Angle_90.getValue(); // 旋转 90° page.setRotation(PdfPageRotateAngle.fromValue(rotation));}

说明：循环遍历 PDF 所有页面，为每页加上 90° 旋转，实现快速批量旋转。

Java PDF 页面动态旋转示例（用户输入）

有时你希望根据用户输入旋转 PDF 页面，如自定义角度或特定页码范围。以下示例展示动态旋转实现：

import java.util.Scanner;import com.spire.pdf.PdfDocument;import com.spire.pdf.PdfPageBase;import com.spire.pdf.PdfPageRotateAngle;public class DynamicRotate { public static void main(String[] args) { Scanner scanner = new Scanner(System.in); System.out.print("请输入 PDF 文件路径："); String filePath = scanner.nextLine(); System.out.print("请输入旋转角度（90,180,270）："); int angle = scanner.nextInt(); System.out.print("请输入要旋转的页面范围（如 1-3 或 all）："); String pageRange = scanner.next(); PdfDocument pdf = new PdfDocument(); pdf.loadFromFile(filePath); int startPage = 0, endPage = pdf.getPages().getCount() - 1; if (!pageRange.equalsIgnoreCase("all")) { String[] parts = pageRange.split("-"); startPage = Integer.parseInt(parts[0]) - 1; endPage = Integer.parseInt(parts[1]) - 1; } for (int i = startPage; i <= endPage; i++) { PdfPageBase page = pdf.getPages().get(i); int rotation = page.getRotation().getValue(); rotation += angle; page.setRotation(PdfPageRotateAngle.fromValue(rotation)); } pdf.saveToFile("RotatedOutput.pdf"); System.out.println("指定页面旋转完成！"); }}

说明：用户可输入 PDF 文件路径、旋转角度和页码范围，程序计算旋转并应用到指定页面，最后生成新 PDF 文件。

Java PDF 页面旋转实际应用场景纠正扫描文档：自动修正扫描 PDF 页面方向批量报告处理：将多份报告旋转到统一方向打印准备：确保内容打印方向正确

此技术可用于自动化流程、文档管理系统或后台批量处理场景。

Java PDF 页面旋转注意事项旋转仅改变页面方向；内容坐标不变旋转角度累加：原始角度 + 新旋转角度保存输出：旋转后的 PDF 需另存为新文件总结

本文介绍了Java PDF 页面旋转方法及实用示例：

单页旋转所有页面旋转基于用户输入的动态旋转

通过程序化旋转 PDF 页面，可以提高处理效率、保证文档排版统一，适用于扫描文件、报告处理和打印准备。