使用Apache POI读取Xlsx时识别合并单元格及取值问题

1. 判断目标单元格是否为合并单元格 #

以Apache POI（Java）为例，核心思路是通过工作表的合并区域集合，检查目标单元格是否落在某个合并范围内：

• 先获取工作表的合并区域列表：List<CellRangeAddress> mergedRegions = sheet.getMergedRegions();
• 遍历列表，用CellRangeAddress.isInRange(rowIndex, colIndex)方法判断目标单元格（注意POI中行/列索引从0开始，比如N11对应行索引10、列索引13）是否属于某个合并区域
• 若返回true，则该单元格是合并单元格；同时可通过getFirstRow()和getFirstColumn()判断是否为合并区域的左上角单元格

示例代码片段：

Sheet sheet = workbook.getSheetAt(0);
List<CellRangeAddress> mergedRegions = sheet.getMergedRegions();
boolean isMerged = false;
CellRangeAddress targetRegion = null;

// 检查N11（行10，列13）是否为合并单元格
for (CellRangeAddress region : mergedRegions) {
    if (region.isInRange(10, 13)) {
        isMerged = true;
        targetRegion = region;
        break;
    }
}

2. 获取非左上角合并单元格的对应值 #

合并单元格的实际值仅存储在左上角单元格中，非左上角单元格直接读取会返回null，解决方案是：

• 找到目标单元格所属的合并区域后，直接读取该区域左上角单元格的值
• 针对N11的场景：
  1. 确认N11所属的合并区域targetRegion
  2. 获取区域左上角单元格：sheet.getRow(targetRegion.getFirstRow()).getCell(targetRegion.getFirstColumn())
  3. 调用单元格值解析方法，统一处理不同数据类型（字符串、数字、日期等）

示例代码片段：

if (isMerged) {
    Cell valueCell;
    // 判断是否为左上角单元格
    if (targetRegion.getFirstRow() == 10 && targetRegion.getFirstColumn() == 13) {
        valueCell = sheet.getRow(10).getCell(13);
    } else {
        // 读取左上角单元格
        valueCell = sheet.getRow(targetRegion.getFirstRow())
                         .getCell(targetRegion.getFirstColumn());
    }
    // 解析单元格值
    String cellValue = parseCellValue(valueCell);
}

// 辅助方法：统一解析不同类型的单元格值
private static String parseCellValue(Cell cell) {
    if (cell == null) return "";
    switch (cell.getCellType()) {
        case STRING:
            return cell.getStringCellValue();
        case NUMERIC:
            return DateUtil.isCellDateFormatted(cell) 
                   ? cell.getDateCellValue().toString() 
                   : String.valueOf(cell.getNumericCellValue());
        case BOOLEAN:
            return String.valueOf(cell.getBooleanCellValue());
        case FORMULA:
            return cell.getCellFormula();
        default:
            return "";
    }
}

内容的提问来源于stack exchange，提问作者Игнат Тимофеев