使用 Apache POI 实现 Excel 单元格归并

在一样平常工作中，Excel 是一个不可或缺的工具，尤其是在处置惩罚大量数据时。为了提拔数据的可读性和雅观性，我们经常必要对 Excel 中的单元格进行归并操作。本文将介绍如何使用 Apache POI 库在 Java 中实现 Excel 单元格的归并，并提供一个现成的工具类供大家使用。
工具类介绍

我们提供了一个名为 ExcelMergeUtility 的工具类，它可以资助你轻松地归并 Excel 中的单元格。该类支持纵向归并（按行归并）和横向归并（按列归并），而且可以指定必要归并的列。
工具类代码

1. import org.apache.poi.ss.usermodel.*;
2. import org.apache.poi.ss.util.CellRangeAddress;
3. import org.springframework.stereotype.Component;
5. import java.io.FileInputStream;
6. import java.io.FileOutputStream;
7. import java.io.IOException;
8. import java.util.List;
10. @Component
11. public class ExcelMergeUtility {
13.     /**
14.      * 合并Excel中内容相同的单元格
15.      *
16.      * @param workbook       工作簿
17.      * @param sheetName      工作表名称
18.      * @param columnsToMerge 需要合并的列索引列表
19.      * @param isRowMerge     是否按行合并（纵向合并）
20.      * @param isColumnMerge  是否按列合并（横向合并）
21.      */
22.     public void mergeCells(Workbook workbook, String sheetName, List<Integer> columnsToMerge,
23.                            boolean isRowMerge, boolean isColumnMerge) {
24.         Sheet sheet = workbook.getSheet(sheetName);
25.         if (sheet == null) {
26.             throw new IllegalArgumentException("工作表 " + sheetName + " 不存在");
27.         }
29.         // 记录第一列的合并行数
30.         int firstColMergeEndRow = 0;
32.         for (int colIndex : columnsToMerge) {
33.             for (int rowIndex = 0; rowIndex <= sheet.getLastRowNum(); rowIndex++) {
34.                 Row currentRow = sheet.getRow(rowIndex);
35.                 if (currentRow == null) continue;
37.                 Cell currentCell = currentRow.getCell(colIndex);
38.                 if (currentCell == null) continue;
40.                 String currentValue = currentCell.getStringCellValue();
42.                 if (isRowMerge) {
43.                     // 纵向合并
44.                     int mergeStartRow = rowIndex;
45.                     while (rowIndex + 1 <= sheet.getLastRowNum()) {
46.                         Row nextRow = sheet.getRow(rowIndex + 1);
47.                         if (nextRow == null) break;
49.                         Cell nextCell = nextRow.getCell(colIndex);
50.                         if (nextCell == null || !nextCell.getStringCellValue().equals(currentValue)) break;
52.                         // 如果当前列不是第一列，且合并行数超过前一列的合并行数，则停止合并
53.                         if (colIndex > 0 && rowIndex + 1 > getMergeEndRow(sheet, mergeStartRow, colIndex - 1)) break;
55.                         // 如果合并行数超过第一列的合并行数，则停止合并
56.                         if (colIndex > 0 && rowIndex + 1 > firstColMergeEndRow) break;
58.                         rowIndex++;
59.                     }
60.                     if (mergeStartRow != rowIndex) {
61.                         sheet.addMergedRegion(new CellRangeAddress(mergeStartRow, rowIndex, colIndex, colIndex));
62.                     }
64.                     // 如果是第一列，记录合并的最后一行
65.                     if (colIndex == 0) {
66.                         firstColMergeEndRow = rowIndex;
67.                     }
68.                 }
70.                 if (isColumnMerge) {
71.                     // 横向合并
72.                     int mergeStartCol = colIndex;
73.                     while (colIndex + 1 < currentRow.getLastCellNum()) {
74.                         Cell nextCell = currentRow.getCell(colIndex + 1);
75.                         if (nextCell == null || !nextCell.getStringCellValue().equals(currentValue)) break;
77.                         colIndex++;
78.                     }
79.                     if (mergeStartCol != colIndex) {
80.                         sheet.addMergedRegion(new CellRangeAddress(rowIndex, rowIndex, mergeStartCol, colIndex));
81.                     }
82.                 }
83.             }
84.         }
85.     }
87.     /**
88.      * 获取指定单元格的合并的最后一行
89.      *
90.      * @param sheet     工作表
91.      * @param rowIndex  行索引
92.      * @param colIndex  列索引
93.      * @return 合并的最后一行
94.      */
95.       private int getMergeEndRow(Sheet sheet, int rowIndex, int colIndex) {
96.         int numMergedRegions = sheet.getNumMergedRegions();
97.         for (int i = 0; i < numMergedRegions; i++) {
98.             CellRangeAddress mergedRegion = sheet.getMergedRegion(i);
99.             if (mergedRegion.isInRange(rowIndex, colIndex)) {
100.                 return mergedRegion.getLastRow();
101.             }
102.         }
103. //        for (CellRangeAddress mergedRegion : sheet.getMergedRegions()) {
104. //            if (mergedRegion.isInRange(rowIndex, colIndex)) {
105. //                return mergedRegion.getLastRow();
106. //            }
107. //        }
108.         return rowIndex; // 如果没有合并，则返回当前行
109.     }
111.     /**
112.      * 示例：生成Excel并合并单元格
113.      */
114.     public void generateAndMergeExcel(String filePath, String sheetName, List<Integer> columnsToMerge,
115.                                       boolean isRowMerge, boolean isColumnMerge) throws IOException {
116.         // 打开现有的Excel文件
117.         Workbook workbook = WorkbookFactory.create(new FileInputStream(filePath));
119.         // 合并单元格
120.         mergeCells(workbook, sheetName, columnsToMerge, isRowMerge, isColumnMerge);
122.         // 写入文件
123.         try (FileOutputStream fileOut = new FileOutputStream(filePath)) {
124.             workbook.write(fileOut);
125.         }
127.         workbook.close();
128.     }
129. }

复制代码

调用示例

1. List<Integer> columnsToMerge = Arrays.asList(0, 1, 2, 3, 4, 5); // 合并第1列和第2列
2. boolean isRowMerge = true; // 启用纵向合并
3. boolean isColumnMerge = false; // 禁用横向合并
5. excelMergeUtility.generateAndMergeExcel("C:\\Users\\xxxx\\Downloads\\汇总记录2025-03-04%2B10_38_30.xls", "汇总", columnsToMerge, isRowMerge, isColumnMerge);

复制代码

依赖配置

为了使用这个工具类，你必要在你的项目中添加 Apache POI 的依赖：

1. <!-- Apache POI 核心库 -->
2. <dependency>
3.     <groupId>org.apache.poi</groupId>
4.     <artifactId>poi</artifactId>
5.     <version>4.1.2</version>
6. </dependency>
7. <!-- Apache POI OOXML 库，用于处理 .xlsx 文件 -->
8. <dependency>
9.     <groupId>org.apache.poi</groupId>
10.     <artifactId>poi-ooxml</artifactId>
11.     <version>4.1.2</version>
12. </dependency>

复制代码

总结

通过 ExcelMergeUtility 工具类，你可以轻松地实现 Excel 单元格的归并操作。无论是纵向归并还是横向归并，该工具类都能满足你的需求。盼望本文对你有所资助，欢迎在评论区分享你的使用体验和问题。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。