java操作excel最常用工具是apache poi库,支持读写.xls和.xlsx格式。1. 使用maven添加poi-ooxml依赖处理.xlsx文件或poi处理.xls文件;2. 读取时根据文件类型创建workbook对象,遍历sheet和row并读取cell内容,注意处理不同类型和空单元格;3. 写入时创建workbook、sheet、row和cell,设置内容后输出到文件流,并可设置样式及优化性能;4. 注意兼容性、性能优化(如sxssf模型)、空指针异常处理及公式计算问题。掌握这些基础操作有助于进一步深入应用。

Java操作Excel文件最常用的工具是Apache POI库,它支持读写.xls和.xlsx格式的文件。如果你需要用Java处理Excel数据,比如生成报表、导入导出数据等,POI几乎是首选方案。

下面我们就来看看怎么用POI来读写Excel文件。
1. 添加POI依赖
在开始编码前,先要确保项目中引入了POI的依赖。如果你使用Maven,可以在pom.xml中添加以下内容:
立即学习“Java免费学习笔记(深入)”;

org.apache.poi poi-ooxml 5.2.3
这个包包含了处理.xlsx格式文件所需的所有类。如果是旧版.xls文件,则需要引入poi而不是poi-ooxml。
2. 读取Excel文件
读取Excel通常是为了提取数据,比如从用户上传的表格中获取信息。POI提供了两种主要类:HSSFWorkbook用于.xls文件,XSSFWorkbook用于.xlsx文件。

基本流程如下:
- 打开文件输入流
- 创建Workbook对象
- 遍历Sheet和Row,读取Cell内容
示例代码:
FileInputStream fis = new FileInputStream("data.xlsx");
Workbook workbook = new XSSFWorkbook(fis);
Sheet sheet = workbook.getSheetAt(0);
for (Row row : sheet) {
for (Cell cell : row) {
System.out.print(cell.toString() + "\t");
}
System.out.println();
}需要注意的是:
- 不同类型的单元格(数字、字符串、日期)要用不同的方法获取值,例如
getStringCellValue()或getNumericCellValue() - 空单元格可能会抛异常,建议加判断或使用
getCell()时指定Row.MissingCellPolicy.RETURN_BLANK_AS_NULL
3. 写入Excel文件
写入Excel常用于导出数据,比如将数据库查询结果保存为Excel文件。
步骤大致如下:
- 创建Workbook对象
- 创建Sheet和Row
- 设置Cell内容
- 输出到文件流
示例代码:
Workbook workbook = new XSSFWorkbook();
Sheet sheet = workbook.createSheet("数据表");
Row headerRow = sheet.createRow(0);
Cell cell = headerRow.createCell(0);
cell.setCellValue("姓名");
cell = headerRow.createCell(1);
cell.setCellValue("年龄");
Row dataRow = sheet.createRow(1);
dataRow.createCell(0).setCellValue("张三");
dataRow.createCell(1).setCellValue(25);
FileOutputStream fos = new FileOutputStream("output.xlsx");
workbook.write(fos);
fos.close();一些小技巧:
- 可以设置样式,比如字体、颜色、对齐方式
- 使用
AutoFlushable模式可以提高大文件写入性能 - 写完后记得关闭流,避免资源泄漏
4. 常见问题与注意事项
-
兼容性问题:POI 3.17之后版本推荐使用
poi-ooxml,但要注意JDK版本是否兼容 -
性能问题:如果数据量特别大,建议使用
SXSSF模型,它是基于磁盘缓存的,内存占用低 -
空指针异常:读取单元格时,建议使用
Row.getCell(int, Row.MissingCellPolicy)来避免空指针 -
公式计算:如果Excel里有公式,读取时不会自动计算,需要调用
FormulaEvaluator
基本上就这些。POI功能强大,但也有一些细节容易踩坑,比如类型转换、样式设置、性能优化等。掌握好基础操作后,可以根据具体需求进一步深入学习。










