Excel-Spring-Boot-Starter 使用教程

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

项目介绍

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
}