Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
E

ExcelKit

> 编程语言
Open source

Excel导入导出工具(简单、好用且轻量级的海量Excel文件导入导出解决方案.)ISSUES/PR请前往:https://gitee.com/wuwenze/ExcelKit

361 stars0 likes1 views
WebsiteGitHub

About

Excel导入导出工具(简单、好用且轻量级的海量Excel文件导入导出解决方案.)ISSUES/PR请前往:https://gitee.com/wuwenze/ExcelKit

ExcelKit

简单、好用且轻量级的海量Excel文件导入导出解决方案。

注意

停止维护,建议使用EasyExcel:https://github.com/alibaba/easyexcel

POM.xml

xml

    com.wuwenze
    ExcelKit
    2.0.72

示例

1. ExcelMapping (配置Excel与实体之间的映射关系)

现支持两种配置方式: 注解 或者 XML

…

XML 配置方式, 必须需将 xml 文件放置在classpath:excel-mapping/{entityClassName}.xml

java
public class User2 {

  private Integer userId;
  private String username;
  private String password;
  private String email;
  private Integer sex;
  private UserGroup userGroup;
  private Date createAt;
  private Integer customizeField;
  
  // Getter and Setter ..
}

classpath:excel-mapping/com.wuwenze.entity.User2.xml

xml

  
  
  
  
  
  
  
  

以上两种方式2选一即可, ExcelKit 会优先装载 XML 配置文件.

2. 实现相关的转换器

通过实现com.wuwenze.poi.config.Options自定义导入模板的下拉框数据源。

java
public class UserGroupNameOptions implements Options {

  @Override
  public String[] get() {
    return new String[]{"管理组", "普通会员组", "游客"};
  }
}

通过实现com.wuwenze.poi.validator.Validator自定义单元格导入时的验证规则。

java
public class UsernameValidator implements Validator {
  final List ERROR_USERNAME_LIST = Lists.newArrayList(
      "admin", "root", "master", "administrator", "sb"
  );

  @Override
  public String valid(Object o) {
    String username = (String) o;
    if (username.length() > 12) {
      return "用户名不能超过12个字符。";
    }

    if (ERROR_USERNAME_LIST.contains(username)) {
      return "用户名非法,不允许使用。";
    }
    return null;
  }
}

实现com.wuwenze.poi.convert.WriteConverter以及com.wuwenze.poi.convert.ReadConverter单元格读写转换器。

…

3. 一行代码构建 Excel 导入模板

使用 ExcelKit 提供的API 构建导入模板, 会根据配置生成批注, 下拉框等

java
// 生成导入模板(含3条示例数据)
@RequestMapping(value = "/downTemplate", method = RequestMethod.GET)
public void downTemplate(HttpServletResponse response) {
  List userList = DbUtil.getUserList(3);
  ExcelKit.$Export(User.class, response).downXlsx(userList, true);
}

4. 执行文件导入

使用边读边处理的方式, 无需担心内存溢出, 也不用理会 Excel 文件到底有多大.

…

全部导入成功示例:

部分导入失败示例(包含错误信息):

5. 一行代码执行 Excel 批量导出.

基于 Apache POI SXSSF 系列API实现导出, 大幅优化导出性能.

java
@RequestMapping(value = "/downXlsx", method = RequestMethod.GET)
public void downXlsx(HttpServletResponse response) {
  long beginMillis = System.currentTimeMillis();
  List userList = DbUtil.getUserList(100000);// 生成10w条测试数据
  ExcelKit.$Export(User.class, response).downXlsx(userList, false);
  log.info("#ExcelKit.$Export success, size={},timeConsuming={}s",//
      userList.size(), (System.currentTimeMillis() - beginMillis) / 1000L);
}

需要注意的是,虽然ExcelKit针对导出做了大量优化,但导出数据也需要量力而行。

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Java

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言