零基础教程：5分钟用Java实现Excel转PDF

最新推荐文章于 2026-08-04 11:51:14 发布

原创最新推荐文章于 2026-08-04 11:51:14 发布 · 963 阅读 ·

大模型引用 1 次

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

代码可运行

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

创建一个最简单的Java控制台程序实现Excel转PDF功能，要求：1.使用Maven管理依赖 2.仅需核心POI和iText库 3.代码不超过100行 4.包含完整注释 5.提供示例Excel文件 6.输出带边框的基础表格PDF。避免使用复杂特性，重点展示：文件读取、单元格遍历、PDF生成三个核心步骤。

点击'项目生成'按钮，等待项目生成完整后预览效果

示例图片

最近工作中需要把Excel报表转换成PDF格式，作为Java新手查了很多资料，发现用POI和iText这两个库就能轻松实现。下面分享我的实践过程，特别适合刚入门的朋友快速上手。

一、准备工作

环境搭建
确保本地安装了JDK 1.8+和Maven。推荐使用IDEA或Eclipse，新建一个Maven项目后，在pom.xml添加以下依赖（具体版本可参考Maven仓库最新稳定版）：
org.apache.poi处理Excel读写
com.itextpdf生成PDF文件
示例文件准备
创建一个简单的Excel文件（如test.xlsx），包含3-5行测试数据，确保首行为标题行。这样调试时能快速验证效果。

二、核心实现步骤

读取Excel数据
使用POI的XSSFWorkbook加载Excel文件，通过Sheet和Row对象逐行遍历单元格。注意处理空单元格避免NPE异常，建议用CellType判断数据类型（字符串、数字等）。
创建PDF文档
初始化iText的Document和PdfWriter，设置页面大小和边距。关键点是使用PdfPTable构建表格，列数与Excel标题行一致。
填充表格内容
将Excel每行数据转为PdfPCell，通过addCell()方法插入表格。可简单设置单元格边框和居中对齐样式，提升可读性。
输出PDF文件
最终调用document.close()生成PDF，建议用FileOutputStream指定输出路径（如result.pdf）。

三、调试与优化

常见问题
若遇到中文乱码，检查字体是否支持中文（如BaseFont.createFont("STSong-Light", "UniGB-UCS2-H")）。
性能建议
处理大文件时，可分批读取Excel数据并分段写入PDF，避免内存溢出。

四、完整执行流程示例

在项目根目录放入test.xlsx
运行主类后控制台输出转换进度
查看生成的result.pdf是否符合预期

整个过程代码约80行，核心逻辑集中在数据遍历和格式转换上。作为练习，可以尝试扩展以下功能： - 动态调整表格列宽 - 添加页眉页脚 - 支持合并单元格的转换

体验建议

如果不想本地配置环境，推荐用InsCode(快马)平台在线运行。它内置了Java环境和Maven支持，粘贴代码即可直接测试：

新建Java项目并粘贴上述代码
上传示例Excel文件
点击运行自动生成PDF

示例图片

实际测试发现，平台能自动解析依赖关系，省去了手动下载库的麻烦。对于需要快速验证功能的场景特别友好，生成PDF后还能直接下载到本地。

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

创建一个最简单的Java控制台程序实现Excel转PDF功能，要求：1.使用Maven管理依赖 2.仅需核心POI和iText库 3.代码不超过100行 4.包含完整注释 5.提供示例Excel文件 6.输出带边框的基础表格PDF。避免使用复杂特性，重点展示：文件读取、单元格遍历、PDF生成三个核心步骤。