当前位置：首页 > news >正文

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

news 2026/2/8 14:38:21

前情提要

首先需要明确自己需要导出的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("导出任务失败！");}}