使用iText将Word文档转换为PDF的完整指南

引言

在企业应用中，将Word文档转换为PDF是一项常见需求。iText作为Java中强大的PDF库，虽然本身不直接支持Word格式，但通过与Apache POI等工具结合，可以轻松实现转换。本文将介绍如何使用iText完成Word到PDF的转换。

环境准备

首先，在项目中添加必要的依赖。以Maven为例：

<dependency> <groupId>com.itextpdf</groupId> <artifactId>itext7-core</artifactId> <version>7.2.5</version> </dependency> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.3</version> </dependency> 

注意：iText 7需要额外添加字形包（如果使用中文等非英文字符），建议添加pdfCalligraph或使用字体设置。

转换流程

基本思路：使用Apache POI读取Word文档的内容（文本、表格、图片等），然后使用iText在PDF中重新绘制。以下是一个简单的示例：

import com.itextpdf.kernel.pdf.PdfDocument; import com.itextpdf.kernel.pdf.PdfWriter; import com.itextpdf.layout.Document; import com.itextpdf.layout.element.Paragraph; import org.apache.poi.xwpf.usermodel.XWPFDocument; import org.apache.poi.xwpf.usermodel.XWPFParagraph; import java.io.FileInputStream; import java.io.FileOutputStream; public class WordToPdfConverter { public static void main(String[] args) throws Exception { String wordPath = "input.docx"; String pdfPath = "output.pdf"; // 读取Word文档 XWPFDocument wordDoc = new XWPFDocument(new FileInputStream(wordPath)); // 创建PDF文档 PdfDocument pdfDoc = new PdfDocument(new PdfWriter(pdfPath)); Document pdfLayout = new Document(pdfDoc); // 遍历Word段落 for (XWPFParagraph para : wordDoc.getParagraphs()) { String text = para.getText(); if (text != null && !text.trim().isEmpty()) { pdfLayout.add(new Paragraph(text)); } } // 关闭文档 pdfLayout.close(); wordDoc.close(); System.out.println("转换完成！"); } } 

处理复杂内容

上面的示例只处理了纯文本。实际场景中Word可能包含表格、图片、样式等。需要针对不同元素扩展：

• 表格：使用POI的XWPFTable读取，然后调用iText的Table类渲染。
• 图片：通过XWPFPictureData获取字节流，使用iText的Image添加到PDF。
• 样式：从POI的XWPFRun中获取字体、颜色、粗细等信息，映射到iText的Text对象。

注意事项

1. 字体支持：中文等非拉丁字符需要设置字体。建议使用iText的PdfFont注册中文字体文件（如宋体）。
2. 布局精度：Word和PDF的布局模型不同，转换可能无法完全一致，需针对关键内容进行微调。
3. 性能优化：大文件转换时注意内存管理，可考虑流式处理。

替代方案

如果不想手动编码，可以选用基于iText的商业库（如iText 7的PDF转换插件）或使用LibreOffice的命令行转换。但手动编码提供更高的定制性。

结语

通过iText和Apache POI的结合，您可以实现高度可控的Word到PDF转换。本文提供了一个基础框架，读者可根据实际需求扩展。希望这篇指南能为您的工作带来帮助。