Excel-Spring-Boot-Starter 使用教程

2026-01-18 09:59:31作者：齐添朝

excel-spring-boot-starter 是一款高效、轻量级的Spring Boot插件，专门用于简化Excel文件的读写操作。依托于强大的EasyExcel库，它能在有限资源下轻松处理超大Excel文件，如64MB内存环境下一分钟即可解析完75MB的文件。此插件全面兼容Spring Boot最新版本，并与Maven仓库无缝对接，让你一键引入，立即体验到Excel处理从未有过的流畅与便捷。不仅于此，它还提供了丰富的功能扩展，包括但不限于JSR 303数据验证、自定义样式设定、多表单导出、数据加密等，让开发者在面对复杂需求时也能游刃有余。无论你是初学者还是经验丰富的开发人员，excel-spring-boot-starter都是提升工作效率的理想选择。

项目地址：https://gitcode.com/gh_mirrors/exc/excel-spring-boot-starter

项目介绍

Excel-Spring-Boot-Starter 是一个基于 Spring Boot 的快速开发工具，专门用于处理 Excel 文件的读写操作。该项目集成了阿里巴巴的 EasyExcel 库，提供了简单、高效的 Excel 处理能力，适用于数据导入、导出、报表生成等多种场景。

项目快速启动

1. 添加依赖

首先，在你的 Spring Boot 项目的 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.pig4cloud</groupId>
    <artifactId>excel-spring-boot-starter</artifactId>
    <version>最新版本</version>
</dependency>

2. 配置文件

在 application.yml 或 application.properties 文件中添加必要的配置：

excel:
  config:
    path: /path/to/save/excel

3. 编写代码

创建一个简单的 Controller 来处理 Excel 文件的导出：

import com.alibaba.excel.EasyExcel;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.net.URLEncoder;

@RestController
@RequestMapping("/excel")
public class ExcelController {

    @GetMapping("/export")
    public void export(HttpServletResponse response) throws IOException {
        response.setContentType("application/vnd.ms-excel");
        response.setCharacterEncoding("utf-8");
        String fileName = URLEncoder.encode("测试", "UTF-8");
        response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".xlsx");
        EasyExcel.write(response.getOutputStream()).head(Head.class).sheet("模板").doWrite(data());
    }

    private List<Head> data() {
        List<Head> list = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            Head head = new Head();
            head.setName("姓名" + i);
            head.setAge(i + 20);
            list.add(head);
        }
        return list;
    }
}

class Head {
    private String name;
    private int age;

    // Getters and Setters
}