Java案例如何实现Excel导入导出？

本文目录导读：

1. 方式一：使用 EasyExcel（推荐）
2. 方式二：使用 Apache POI（传统方案）
3. 总结与选择建议

在Java中实现Excel导入导出，主要有两种主流的开源库：Apache POI 和 EasyExcel。

• Apache POI：功能最全，支持xls和xlsx，但内存消耗较大,速度较慢。
• EasyExcel（阿里开源的）：基于POI进行了封装和重写，内存占用极低，特别适合处理大数据量,API更简洁。

下面是基于 EasyExcel 的完整案例（推荐使用），因为它最符合现代Java开发的需求（更少的代码、更低的内存），如果你需要兼容非常古老的xls格式或对POI有特殊需求,我也会在最后提到POI版本。

使用 EasyExcel（推荐）

首先在 pom.xml 中添加依赖：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>4.0.3</version> <!-- 请使用最新稳定版 -->
</dependency>

定义数据模型（对应Excel表头）

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;
@Data
public class UserData {
    // index属性指定列的顺序（从0开始），value属性指定表头名称
    @ExcelProperty(value = "用户ID", index = 0)
    private Integer userId;
    @ExcelProperty(value = "用户名", index = 1)
    private String userName;
    @ExcelProperty(value = "年龄", index = 2)
    private Integer age;
    @ExcelProperty(value = "邮箱", index = 3)
    private String email;
}

导出 Excel（写入文件）

import com.alibaba.excel.EasyExcel;
import java.util.ArrayList;
import java.util.List;
public class ExcelExportDemo {
    public static void main(String[] args) {
        // 1. 准备数据（模拟数据库查询结果）
        List<UserData> dataList = new ArrayList<>();
        for (int i = 0; i < 100; i++) {
            UserData user = new UserData();
            user.setUserId(i + 1);
            user.setUserName("用户" + i);
            user.setAge(20 + i % 30);
            user.setEmail("user" + i + "@example.com");
            dataList.add(user);
        }
        // 2. 定义导出的文件路径
        String fileName = "用户数据.xlsx";
        // 3. 写入文件
        // 第一个参数：文件路径
        // 第二个参数：数据模型的Class
        // 第三个参数：数据集合
        // sheet("用户列表")：指定Sheet页名称
        EasyExcel.write(fileName, UserData.class)
                .sheet("用户列表")
                .doWrite(dataList);
        System.out.println("导出成功！文件路径：" + fileName);
    }
}

导入 Excel（读取文件）

EasyExcel最大的优势之一：通过监听器一行一行读取,避免内存溢出。

import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.read.listener.ReadListener;
import java.util.ArrayList;
import java.util.List;
// 自定义监听器，每次读取一行数据都会回调
public class UserDataListener implements ReadListener<UserData> {
    // 缓存每批读取的数据（例如每100条批量处理一次）
    private List<UserData> cachedDataList = new ArrayList<>();
    // 每读取一行数据，该方法被调用
    @Override
    public void invoke(UserData data, AnalysisContext context) {
        cachedDataList.add(data);
        // 达到批量处理阈值时，可以进行数据库插入等操作
        if (cachedDataList.size() >= 100) {
            // 模拟批量保存
            saveData(cachedDataList);
            // 清空缓存
            cachedDataList = new ArrayList<>();
        }
    }
    // 所有数据读取完毕后，如果有剩余数据，也需要处理
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        if (cachedDataList.size() > 0) {
            saveData(cachedDataList);
        }
        System.out.println("所有数据读取完成！");
    }
    // 模拟保存到数据库
    private void saveData(List<UserData> dataList) {
        System.out.println("成功处理 " + dataList.size() + " 条数据");
        // 实际业务中这里调用数据库批量插入
    }
}

调用导入方法：

public class ExcelImportDemo {
    public static void main(String[] args) {
        String fileName = "用户数据.xlsx";
        // 第一个参数：文件路径
        // 第二个参数：数据模型Class
        // 第三个参数：监听器（new 一个）
        EasyExcel.read(fileName, UserData.class, new UserDataListener())
                .sheet() // 读取第一个Sheet
                .doRead(); // 开始执行读取
        System.out.println("导入完成！");
    }
}

使用 Apache POI（传统方案）

如果你的项目必须使用POI（比如需要操作复杂的Excel样式、宏、xls格式）,可以参考以下样板代码。

添加 Maven 依赖

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId> <!-- 包含xlsx支持 -->
    <version>5.3.0</version>
</dependency>

导出 Excel（POI实现）

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.FileOutputStream;
import java.util.List;
public class POIExportDemo {
    public static void exportToExcel(List<UserData> userList, String filePath) throws Exception {
        Workbook workbook = new XSSFWorkbook();
        Sheet sheet = workbook.createSheet("用户列表");
        // 1. 创建表头
        Row headerRow = sheet.createRow(0);
        String[] headers = {"用户ID", "用户名", "年龄", "邮箱"};
        for (int i = 0; i < headers.length; i++) {
            Cell cell = headerRow.createCell(i);
            cell.setCellValue(headers[i]);
            // 给表头设置样式（可选）
            CellStyle style = workbook.createCellStyle();
            Font font = workbook.createFont();
            font.setBold(true);
            style.setFont(font);
            cell.setCellStyle(style);
        }
        // 2. 填充数据
        int rowIndex = 1;
        for (UserData user : userList) {
            Row row = sheet.createRow(rowIndex++);
            row.createCell(0).setCellValue(user.getUserId());
            row.createCell(1).setCellValue(user.getUserName());
            row.createCell(2).setCellValue(user.getAge());
            row.createCell(3).setCellValue(user.getEmail());
        }
        // 3. 写入文件
        try (FileOutputStream fos = new FileOutputStream(filePath)) {
            workbook.write(fos);
        }
        workbook.close(); // 关闭资源
    }
}

导入 Excel（POI实现）

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.FileInputStream;
import java.util.ArrayList;
import java.util.List;
public class POIImportDemo {
    public static List<UserData> importFromExcel(String filePath) throws Exception {
        List<UserData> userList = new ArrayList<>();
        // 注意：如果文件是xls格式，使用HSSFWorkbook
        try (FileInputStream fis = new FileInputStream(filePath);
             Workbook workbook = new XSSFWorkbook(fis)) {
            Sheet sheet = workbook.getSheetAt(0); // 读取第一个Sheet
            for (int i = 1; i <= sheet.getLastRowNum(); i++) { // 从第1行开始（跳过表头）
                Row row = sheet.getRow(i);
                if (row == null) continue;
                UserData user = new UserData();
                // 注意：POI读取时需要处理单元格类型（数字、字符串等）
                user.setUserId((int) row.getCell(0).getNumericCellValue());
                user.setUserName(row.getCell(1).getStringCellValue());
                user.setAge((int) row.getCell(2).getNumericCellValue());
                user.setEmail(row.getCell(3).getStringCellValue());
                userList.add(user);
            }
        }
        return userList;
    }
}

总结与选择建议

我的建议：

• 95%的新项目：直接使用 EasyExcel,简单高效。
• 需要复杂的Excel样式（如合并单元格、条件格式、图表等）：使用 POI。
• 需要兼容上古xls格式：使用 POI（HSSFWorkbook）。

就是Java实现Excel导入导出的完整案例，两种主流方式都覆盖了,你可以根据实际项目情况选择合适的方式。