java怎样生成和导出Excel文件 java数据导出的基础操作教程

日期：2025-08-18 00:00 / 作者：蓮花仙者

使用Apache POI生成Excel文件需添加依赖并编写代码创建Workbook、Sheet和Row，将数据写入单元格并导出为文件。1. 添加Maven或Gradle依赖；2. 使用XSSFWorkbook创建.xlsx文件；3. 写入数据并自动调整列宽；4. 通过FileOutputStream输出文件。大数据量时可用SXSSFWorkbook或EasyExcel减少内存占用。性能优化包括复用CellStyle、流式写入、批量处理和异步导出。自定义样式可通过CellStyle设置字体、颜色、格式等，EasyExcel支持注解简化操作。选择方案应根据数据量、性能和格式需求决定。

Java生成和导出Excel文件，本质上就是将数据按照Excel的格式写入文件。有很多库可以做到这一点，比如Apache POI、EasyExcel等等。选择哪个取决于你的项目需求，比如数据量大小、性能要求、以及对Excel格式的复杂程度要求。

解决方案

最常用的方法就是使用Apache POI。它是一个非常成熟的库，可以处理各种Excel格式。

添加依赖:

首先，需要在你的Maven或者Gradle项目中添加Apache POI的依赖。

Maven:


    org.apache.poi
    poi
    5.2.3 


    org.apache.poi
    poi-ooxml
    5.2.3

Gradle:

implementation 'org.apache.poi:poi:5.2.3'
implementation 'org.apache.poi:poi-ooxml:5.2.3'

编写代码:

下面是一个简单的例子，展示如何使用POI生成一个Excel文件，并将一些数据写入其中。

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class ExcelExporter {

    public static void main(String[] args) throws IOException {
        // 模拟数据
        List data = new ArrayList<>();
        data.add(new String[]{"姓名", "年龄", "城市"});
        data.add(new String[]{"张三", "25", "北京"});
        data.add(new String[]{"李四", "30", "上海"});
        data.add(new String[]{"王五", "28", "广州"});

        // 创建一个工作簿
        Workbook workbook = new XSSFWorkbook(); // 对于.xlsx格式
        // Workbook workbook = new HSSFWorkbook(); // 对于.xls格式

        // 创建一个工作表
        Sheet sheet = workbook.createSheet("数据");

        // 写入数据
        int rowNum = 0;
        for (String[] rowData : data) {
            Row row = sheet.createRow(rowNum++);
            int colNum = 0;
            for (String cellData : rowData) {
                Cell cell = row.createCell(colNum++);
                cell.setCellValue(cellData);
            }
        }

        // 自动调整列宽
        for (int i = 0; i < data.get(0).length; i++) {
            sheet.autoSizeColumn(i);
        }

        // 将工作簿写入文件
        try (FileOutputStream outputStream = new FileOutputStream("data.xlsx")) {
            workbook.write(outputStream);
        }

        workbook.close();

        System.out.println("Excel文件已生成: data.xlsx");
    }
}

这个例子首先创建了一个

XSSFWorkbook

（对应于

.xlsx

格式），然后创建了一个名为"数据"的工作表。接着，它遍历数据列表，将每一行数据写入工作表。最后，将工作簿写入到名为

data.xlsx

的文件中。

注意事项:
- 选择合适的Workbook类型：
```
XSSFWorkbook
```
  用于
```
.xlsx
```
  格式，
```
HSSFWorkbook
```
  用于
```
.xls
```
  格式。
- 处理异常：在写入文件时，需要处理
```
IOException
```
  。
- 关闭资源：务必在使用完毕后关闭
```
Workbook
```
  和
```
OutputStream
```
  ，释放资源。

EasyExcel是另一个选择，它更轻量级，更适合处理大数据量的Excel导出。使用方式也类似，但API设计上更加简洁。

如何处理Excel导出中的大数据量问题？

大数据量导出是常见的问题。直接使用POI可能会导致内存溢出。

使用SXSSFWorkbook: POI提供了

SXSSFWorkbook

，它是

XSSFWorkbook

的流式版本，可以将数据写入磁盘，从而减少内存占用。

SXSSFWorkbook workbook = new SXSSFWorkbook(100); // 保持100行在内存中，其他的写入磁盘

分页导出: 如果数据量非常大，可以考虑分页查询数据，然后分批写入Excel文件。
使用EasyExcel: EasyExcel本身就对大数据量做了优化，使用起来更加方便。

Excel导出的性能优化有哪些技巧？

性能优化主要集中在减少I/O操作和内存占用上。

减少对象创建: 尽量复用
```
CellStyle
```
等对象，避免重复创建。
使用流式API: 使用
```
SXSSFWorkbook
```
或EasyExcel的流式API。
批量写入: 批量写入数据，减少与磁盘的交互次数。
异步导出: 将导出任务放入后台线程执行，避免阻塞主线程。

如何自定义Excel的样式和格式？

POI和EasyExcel都提供了丰富的API，可以自定义Excel的样式和格式。

使用CellStyle: 可以创建

CellStyle

对象，设置字体、颜色、边框等样式，然后应用到单元格。

CellStyle style = workbook.createCellStyle();
Font font = workbook.createFont();
font.setBold(true);
style.setFont(font);
cell.setCellStyle(style);

使用DataFormat: 可以创建

DataFormat

对象，设置日期、数字等格式。

DataFormat format = workbook.createDataFormat();
CellStyle dateStyle = workbook.createCellStyle();
dateStyle.setDataFormat(format.getFormat("yyyy-MM-dd"));
cell.setCellValue(new Date());
cell.setCellStyle(dateStyle);

使用EasyExcel注解: EasyExcel可以使用注解来简化样式的设置。

@ExcelProperty(value = "日期", index = 0)
@DateTimeFormat("yyyy-MM-dd")
private Date date;

总的来说，Java导出Excel并不难，选择合适的库，了解其特性，就可以满足大部分需求。关键在于理解数据量、性能和格式要求，并选择合适的解决方案。