java进入excel

admin 2026年02月02日 08:19 103 0

Java操作Excel是实现数据处理与报表生成的核心技术，主要通过Apache POI、EasyExcel等库实现，Apache POI功能全面，支持.xls与.xlsx格式，可完成读取、写入、样式设置及公式计算；EasyExcel基于SAX模式，内存占用低，适合大数据量处理，两者广泛应用于企业系统的数据导出、报表生成、模板填充等场景，能有效提升Java与Excel数据交互效率，满足不同业务需求下的表格操作。

Java操作Excel：从入门到实战的完整指南

在企业级应用开发中,Excel作为最常用的数据存储与展示工具，经常需要与Java程序深度结合——例如批量导出报表、导入业务数据、生成分析图表等，本文将系统介绍如何通过Java高效操作Excel，从核心库选型到实战技巧，助您快速掌握Java与Excel的交互能力。

为什么选择Java操作Excel？

Excel文件（.xls/.xlsx）是办公场景中的"通用语言"，而Java作为企业级开发的主流语言，两者结合能释放强大的数据处理潜力：

自动化报表：定时生成销售/财务报表，替代人工整理
数据导入导出：批量处理用户数据、订单信息，降低人工录入错误率
数据可视化：结合Excel图表功能，将Java处理后的数据直观呈现
跨平台兼容：Java的跨平台特性与Excel的通用性，确保系统在多环境下稳定运行

Java操作Excel的核心库选型

Apache POI

优势：
- 老牌开源库,功能全面，支持.xls和.xlsx格式
- 支持复杂操作：合并单元格、自定义样式、插入图片/公式
劣势：
内存占用高,处理大数据量（10万行+）易触发OOM
适用场景：
- 中小数据量场景
- 需要复杂格式操作（如报表模板定制）

EasyExcel（阿里开源）

优势：
- 基于POI优化,采用"逐行读写"模式，支持百万级数据处理
- API简洁,学习成本低，内存占用仅为POI的1/10
劣势：
功能相对POI精简,不支持图表/VBA等高级特性
适用场景：
- 大数据量导出/导入（如电商订单导出）
- 简单格式处理（如用户数据批量导入）

JXL

优势：
轻量级库,API简单
劣势：
- 仅支持.xls格式，已停止更新多年
适用场景：
- 仅处理旧版Excel文件
- 极简操作需求

选型建议：

graph LR
A[数据量] -->|<10万行| B[EasyExcel]
A -->|>10万行| C[EasyExcel]
B -->|复杂格式| D[Apache POI]
C -->|复杂格式| D

环境搭建：以EasyExcel为例

Maven依赖

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.2</version>
</dependency>

核心概念

概念	作用	示例
WriteSheet	写入的Sheet页	`sheet("用户列表")`
WriteTable	写入的表格结构	`table(1)`
AnalysisEventListener	读取监听器	自定义监听器实现逐行解析

实战案例：用户数据导出与导入

场景1：导出用户数据（EasyExcel写入）

步骤1：定义实体类

@Data
@HeadRowHeight(20) // 表头高度
@ContentRowHeight(15) // 内容行高度
public class User {
    @ExcelProperty("姓名") // Excel列名
    private String name;
    @ExcelProperty("年龄")
    private Integer age;
    @ExcelProperty("邮箱")
    private String email;
}

步骤2：写入数据

public class ExcelExportDemo {
    public static void main(String[] args) {
        // 准备数据
        List<User> userList = Arrays.asList(
            new User("张三", 25, "zhangsan@example.com"),
            new User("李四", 30, "lisi@example.com"),
            new User("王五", 28, "wangwu@example.com")
        );
        // 写入Excel
        String fileName = "users.xlsx";
        EasyExcel.write(fileName, User.class)
                .sheet("用户列表")
                .doWrite(userList);
        System.out.println("Excel导出成功：" + fileName);
    }
}

效果：生成包含表头和3行数据的users.xlsx

场景2：读取Excel数据（EasyExcel读取）

步骤1：定义监听器

public class UserExcelListener extends AnalysisEventListener<User> {
    private List<User> userList = new ArrayList<>();
    @Override
    public void invoke(User user, AnalysisContext context) {
        userList.add(user);
        System.out.println("解析到数据：" + user);
    }
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        System.out.println("所有数据解析完成！");
    }
    public List<User> getUserList() {
        return userList;
    }
}

步骤2：读取Excel

public class ExcelImportDemo {
    public static void main(String[] args) {
        String fileName = "users.xlsx";
        UserExcelListener listener = new UserExcelListener();
        EasyExcel.read(fileName, User.class, listener)
                .sheet("用户列表")
                .doRead();
        List<User> users = listener.getUserList();
        System.out.println("共读取到" + users.size() + "条用户数据");
    }
}

高级技巧与最佳实践

大数据量处理：
- 使用ExcelWriter的finish()方法及时释放资源
- 采用分页查询+分批写入模式（每5000行刷新一次）

复杂表头处理：

@ExcelProperty(value = {"用户信息", "姓名"}, index = 0)
private String name;

数据校验：

@ExcelProperty(value = "年龄", converter = IntegerConverter.class)
private Integer age;

样式定制：

@HeadStyle(fillForegroundColor = IndexedColors.GREY_25.getIndex())
@ContentStyle(fillForegroundColor = IndexedColors.YELLOW.getIndex())
private String name;

性能优化：
- 禁用自动列宽：.registerWriteHandler(new SimpleWriteHandler())
- 使用SXSSFWorkbook（POI）处理超大文件

常见问题解决方案

问题	解决方案
内存溢出(OMM)	使用EasyExcel的流式读取
日期格式乱码	添加`@DateTimeFormat("yyyy-MM-dd")`注解
合并单元格失效	使用`WriteCellData`自定义单元格
读取时跳过表头	设置`headRowNumber(0)`