poi如何实现自定义导出Excel-纵向横向合并单元格，自定义填充数据列

前情提要

首先需要明确自己需要导出的excel构成是如何的，比如我需要导出一个自定义表头的excel表格，第一行A到X是标题需要横向合并单元格，第二行和第三行是表头，A到J需要第二行和第三行纵向合并单元格，K到N的第二行需要横向合并单元格，O到S需要横向合并单元格，T到U需要横向合并单元格，最后V到X需要第二行和第三行纵向合并单元格，再赋值给这些列，合并如图

确保项目中已经包含 Apache POI 的依赖

<dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml</artifactId><version>5.2.3</version> <!-- 请根据需要选择版本 -->
</dependency>

创建表头

写一个创建表头的方法，首先我们需要创建一个工作簿，再创建一个工作表来存放数据

private void exportPersonnelData(HttpServletResponse response, List<SysUserImportVo> userList) throws IOException {// 创建工作簿Workbook workbook = new XSSFWorkbook();// 创建工作表Sheet sheet = workbook.createSheet("科创");// 创建表头createHeaderRow(workbook, sheet);
}

首先我们按照自己的需要进行表头的创建，我需要先创建一个标题

private static void createHeaderRow(Workbook workbook, Sheet sheet) {// 表头第一行Row row1 = sheet.createRow(0);//在第一行创建row1.setHeightInPoints(25);//设置高度Cell titleCell = row1.createCell(0);//标明是第一行titleCell.setCellValue("我是标题");//写入标题CellStyle titleStyle = workbook.createCellStyle();//创建了一个新的单元格样式对象 Font font = workbook.createFont();//创建了一个新的字体对象 定义单元格中文字的样式font.setFontHeightInPoints((short) 16);//设置字体的高度为16磅font.setBold(true);//将字体设置为粗体titleStyle.setFont(font);//将之前创建的字体应用到单元格样式 // 设置文本居中titleStyle.setAlignment(HorizontalAlignment.CENTER); // 水平居中titleStyle.setVerticalAlignment(VerticalAlignment.CENTER); // 垂直居中titleCell.setCellStyle(titleStyle);sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 23));//合并第一行中的从第0列到第23列的所有单元格，以便在Excel中形成一个大的标题区域//new CellRangeAddress(0, 0, 0, 23) 表示合并的单元格区域：//第一个和第二个参数 0 指定了开始和结束的行号（这里都是第0行）。//第三个和第四个参数 0 和 23 指定了开始和结束的列号（这里是从第0列到第23列）。//这样就会将第一行的第0列到第23列的单元格合并为一个单元格。
}

接下来要进行第二行和第三行的分别纵向横向合并单元格

    private static void createHeaderRow(Workbook workbook, Sheet sheet) {//第二行Row headerRow2 = sheet.createRow(1);//第三行Row row2 = sheet.createRow(2);// 设置“苹果”Cell currentPositionCell = headerRow2.createCell(10);currentPositionCell.setCellValue("苹果");sheet.addMergedRegion(new CellRangeAddress(1, 1, 10, 13)); // 合并“苹果”区域// 设置“香蕉”Cell educationCell = headerRow2.createCell(14);educationCell.setCellValue("香蕉");sheet.addMergedRegion(new CellRangeAddress(1, 1, 14, 18)); // 合并“香蕉”区域// 设置“橙子”Cell zcell = headerRow2.createCell(19);zcell.setCellValue("橙子");sheet.addMergedRegion(new CellRangeAddress(1, 1, 19, 20)); // 合并“橙子”区域// 手动赋值headerRow2.createCell(0).setCellValue("序号");headerRow2.createCell(1).setCellValue("葡萄");headerRow2.createCell(2).setCellValue("草莓");headerRow2.createCell(3).setCellValue("蓝莓");headerRow2.createCell(4).setCellValue("菠萝");headerRow2.createCell(5).setCellValue("芒果");headerRow2.createCell(6).setCellValue("桃子");headerRow2.createCell(7).setCellValue("樱桃");headerRow2.createCell(8).setCellValue("橘子");headerRow2.createCell(9).setCellValue("柚子");row2.createCell(10).setCellValue("红富士");row2.createCell(11).setCellValue("青苹");row2.createCell(12).setCellValue("蜜脆");row2.createCell(13).setCellValue("金帅");row2.createCell(14).setCellValue("卡文迪什");row2.createCell(15).setCellValue("红香蕉");row2.createCell(16).setCellValue("小香蕉");row2.createCell(17).setCellValue("冰淇淋香蕉");row2.createCell(18).setCellValue("香甜香蕉");row2.createCell(19).setCellValue("甜橙");row2.createCell(20).setCellValue("血橙");headerRow2.createCell(21).setCellValue("杏子");headerRow2.createCell(22).setCellValue("李子");headerRow2.createCell(23).setCellValue("酪梨");// 合并第二行和第三行的单元格sheet.addMergedRegion(new CellRangeAddress(1, 2, 0, 0)); // 序号sheet.addMergedRegion(new CellRangeAddress(1, 2, 1, 1)); // 葡萄sheet.addMergedRegion(new CellRangeAddress(1, 2, 2, 2)); // 草莓sheet.addMergedRegion(new CellRangeAddress(1, 2, 3, 3)); // 蓝莓sheet.addMergedRegion(new CellRangeAddress(1, 2, 4, 4)); // 菠萝sheet.addMergedRegion(new CellRangeAddress(1, 2, 5, 5)); // 芒果sheet.addMergedRegion(new CellRangeAddress(1, 2, 6, 6)); // 桃子sheet.addMergedRegion(new CellRangeAddress(1, 2, 7, 7)); // 樱桃sheet.addMergedRegion(new CellRangeAddress(1, 2, 8, 8)); // 橘子sheet.addMergedRegion(new CellRangeAddress(1, 2, 9, 9)); // 柚子sheet.addMergedRegion(new CellRangeAddress(1, 2, 21, 21)); // 杏子sheet.addMergedRegion(new CellRangeAddress(1, 2, 22, 22)); // 李子sheet.addMergedRegion(new CellRangeAddress(1, 2, 23, 23)); // 酪梨}

合并后内容显示如图 但是如何设置单元格格式呢

接下来写一下单元格格式 这样就和上面的表头是一模一样显示了

    private static void createHeaderRow(Workbook workbook, Sheet sheet) {// 创建单元格样式CellStyle cellStyle = workbook.createCellStyle();Font font2 = workbook.createFont();font2.setFontHeightInPoints((short) 12); // 设置字体大小font2.setBold(true); // 设置为粗体cellStyle.setFont(font2);cellStyle.setAlignment(HorizontalAlignment.CENTER); // 水平居中cellStyle.setVerticalAlignment(VerticalAlignment.CENTER); // 垂直居中cellStyle.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex());cellStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);// 设置边框cellStyle.setBorderTop(BorderStyle.THIN);cellStyle.setBorderBottom(BorderStyle.THIN);cellStyle.setBorderLeft(BorderStyle.THIN);cellStyle.setBorderRight(BorderStyle.THIN);//第二行Row headerRow2 = sheet.createRow(1);//第三行Row row2 = sheet.createRow(2);// 设置“苹果”Cell currentPositionCell = headerRow2.createCell(10);currentPositionCell.setCellValue("苹果");sheet.addMergedRegion(new CellRangeAddress(1, 1, 10, 13)); // 合并“苹果”区域currentPositionCell.setCellStyle(cellStyle); // 应用样式// 设置“香蕉”Cell educationCell = headerRow2.createCell(14);educationCell.setCellValue("香蕉");sheet.addMergedRegion(new CellRangeAddress(1, 1, 14, 18)); // 合并“香蕉”区域educationCell.setCellStyle(cellStyle); // 应用样式// 设置“橙子”Cell zcell = headerRow2.createCell(19);zcell.setCellValue("橙子");sheet.addMergedRegion(new CellRangeAddress(1, 1, 19, 20)); // 合并“橙子”区域zcell.setCellStyle(cellStyle); // 应用样式// 手动赋值headerRow2.createCell(0).setCellValue("序号");headerRow2.createCell(1).setCellValue("葡萄");headerRow2.createCell(2).setCellValue("草莓");headerRow2.createCell(3).setCellValue("蓝莓");headerRow2.createCell(4).setCellValue("菠萝");headerRow2.createCell(5).setCellValue("芒果");headerRow2.createCell(6).setCellValue("桃子");headerRow2.createCell(7).setCellValue("樱桃");headerRow2.createCell(8).setCellValue("橘子");headerRow2.createCell(9).setCellValue("柚子");row2.createCell(10).setCellValue("红富士");row2.createCell(11).setCellValue("青苹");row2.createCell(12).setCellValue("蜜脆");row2.createCell(13).setCellValue("金帅");row2.createCell(14).setCellValue("卡文迪什");row2.createCell(15).setCellValue("红香蕉");row2.createCell(16).setCellValue("小香蕉");row2.createCell(17).setCellValue("冰淇淋香蕉");row2.createCell(18).setCellValue("香甜香蕉");row2.createCell(19).setCellValue("甜橙");row2.createCell(20).setCellValue("血橙");headerRow2.createCell(21).setCellValue("杏子");headerRow2.createCell(22).setCellValue("李子");headerRow2.createCell(23).setCellValue("酪梨");// 合并第二行和第三行的单元格sheet.addMergedRegion(new CellRangeAddress(1, 2, 0, 0)); // 序号sheet.addMergedRegion(new CellRangeAddress(1, 2, 1, 1)); // 葡萄sheet.addMergedRegion(new CellRangeAddress(1, 2, 2, 2)); // 草莓sheet.addMergedRegion(new CellRangeAddress(1, 2, 3, 3)); // 蓝莓sheet.addMergedRegion(new CellRangeAddress(1, 2, 4, 4)); // 菠萝sheet.addMergedRegion(new CellRangeAddress(1, 2, 5, 5)); // 芒果sheet.addMergedRegion(new CellRangeAddress(1, 2, 6, 6)); // 桃子sheet.addMergedRegion(new CellRangeAddress(1, 2, 7, 7)); // 樱桃sheet.addMergedRegion(new CellRangeAddress(1, 2, 8, 8)); // 橘子sheet.addMergedRegion(new CellRangeAddress(1, 2, 9, 9)); // 柚子sheet.addMergedRegion(new CellRangeAddress(1, 2, 21, 21)); // 杏子sheet.addMergedRegion(new CellRangeAddress(1, 2, 22, 22)); // 李子sheet.addMergedRegion(new CellRangeAddress(1, 2, 23, 23)); // 酪梨for (int i = 0; i < 10; i++){Cell mergedCell = headerRow2.getCell(i); // 获取合并后的单元格（第一列）mergedCell.setCellStyle(cellStyle); // 应用样式}for (int i = 21; i < 24; i++){Cell mergedCell = headerRow2.getCell(i);mergedCell.setCellStyle(cellStyle); // 应用样式}// 确保第三行的每个单元格都有边框样式for (int i = 0; i < 10; i++) {Cell normalCell = row2.createCell(i);normalCell.setCellStyle(cellStyle); // 应用样式}for (int i = 21; i < 24; i++) {Cell normalCell = row2.createCell(i);normalCell.setCellStyle(cellStyle); // 应用样式}for (int i = 10; i < 21; i++){Cell mergedCell = row2.getCell(i);mergedCell.setCellStyle(cellStyle);}}

设置列宽

在主方法内使用设置列宽的方法，在方法外自行设置

private void exportPersonnelData(HttpServletResponse response, List<SysUserImportVo> userList) throws IOException {// 设置列宽（单位为字符的256倍）setColumnWidths(sheet);
}

    private static void setColumnWidths(Sheet sheet) {sheet.setColumnWidth(0, 256 * 5);   // 序号sheet.setColumnWidth(1, 256 * 10);  // 葡萄sheet.setColumnWidth(2, 256 * 5);   // 草莓sheet.setColumnWidth(3, 256 * 10);  // 蓝莓sheet.setColumnWidth(4, 256 * 15);  // 菠萝sheet.setColumnWidth(5, 256 * 5);   // 芒果sheet.setColumnWidth(6, 256 * 15);  // 桃子sheet.setColumnWidth(7, 256 * 10);  // 樱桃sheet.setColumnWidth(8, 256 * 15);  // 橘子sheet.setColumnWidth(9, 256 * 10);  // 柚子sheet.setColumnWidth(10, 256 * 20); // 红富士sheet.setColumnWidth(11, 256 * 20); // 青苹sheet.setColumnWidth(12, 256 * 10); // 蜜脆sheet.setColumnWidth(13, 256 * 20); // 金帅sheet.setColumnWidth(14, 256 * 15); // 卡文迪什sheet.setColumnWidth(15, 256 * 15); // 红香蕉sheet.setColumnWidth(16, 256 * 20); // 小香蕉sheet.setColumnWidth(17, 256 * 15); // 冰淇淋香蕉sheet.setColumnWidth(18, 256 * 20); // 香甜香蕉sheet.setColumnWidth(19, 256 * 10); // 甜橙sheet.setColumnWidth(20, 256 * 10); // 血橙sheet.setColumnWidth(21, 256 * 10); // 杏子sheet.setColumnWidth(22, 256 * 30); // 李子sheet.setColumnWidth(23, 256 * 15); // 酪梨}

接下来就是在方法内填充数据了

private void exportPersonnelData(HttpServletResponse response, List<SysUserImportVo> userList) throws IOException {// 创建工作簿Workbook workbook = new XSSFWorkbook();// 创建工作表Sheet sheet = workbook.createSheet("科创");// 设置列宽（单位为字符的256倍）setColumnWidths(sheet);// 创建表头createHeaderRow(workbook, sheet);// 填充数据int rowIndex = 3;  // 数据从第4行开始int serialNumber = 1; // 序号从1开始for (SysUserImportVo sysUserImportVo : userList) {Row row = sheet.createRow(rowIndex++);row.createCell(0).setCellValue(serialNumber++);// 序号if (sysUserImportVo.getGrape() != null && !sysUserImportVo.getGrape().isEmpty()) {row.createCell(1).setCellValue(sysUserImportVo.getGrape());// 葡萄} else {row.createCell(1).setBlank(); // 设置为空单元格}// ……以此类推}// 填充完数据之后写入到HttpServletResponse中response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");response.setHeader("Content-Disposition", "attachment; filename=我是标题.xlsx");workbook.write(response.getOutputStream());// 关闭workbook.close();
}

导出调用可以这样写

这边用了个子线程导出 需要注意的一点是 我使用的若依框架获取当前登录用户的信息不可在线程内获取 需要先获取再传入线程中

    public ResponseEntity<String> export(HttpServletResponse response, SysUserImportVo sysUserImportVo) throws IOException{SysUser user = SecurityUtils.getLoginUser().getUser();Long userId = user.getUserId();// 当前登录用户是否是管理员或人事boolean isAdminOrHr = userService.selectRole(userId);sysUserImportVo.setUserId(userId);Long deptId = user.getDeptId();// 提交导出任务到子线程，并获取 Future 对象Future<?> future = executorService.submit(() -> {try {List<Long> deptIds = Collections.emptyList();if (isAdminOrHr || user.isAdmin()) {deptIds = deptMapper.selectAllDeptList().stream().map(SysDept::getDeptId).collect(Collectors.toList());} else {deptIds = getDeptIds(deptId);}List<SysUserImportVo> userList = userService.selectListByMood(sysUserImportVo, deptIds);// 调用方法导出ExcelexportPersonnelData(response, userList);} catch (IOException e) {// 处理异常e.printStackTrace();}});// 使用Future来监听任务的完成情况try {// 可以选择等待任务完成，或者根据情况进行处理future.get(); // 如果希望阻塞等待任务完成return ResponseEntity.ok("导出任务已提交，并且完成！");} catch (Exception e) {// 处理异常e.printStackTrace();return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("导出任务失败！");}}

至此即可实现自定义表头的导出