使用npoi库读取excel合并单元格内容时,核心做法是调用 isheet.getmergedregioncount() 获取合并区域总数,并通过 isheet.getmergedregion(i) 遍历每个区域。对于合并区域内的所有单元格,其实际数据仅存在于该区域的左上角单元格中,因此只需判断当前单元格的行号和列号是否等于某个合并区域的起始坐标,若是则直接读取该位置的值,否则跳过或复用已读数据。

如何识别单个合并区域的边界范围
要确定一个合并单元格的范围,需要解析 MergedCell 对象中的 FirstRow、LastRow、FirstCol 和 LastCol 属性。这些属性定义了该区域在网格中的绝对坐标。例如,若某区域从第0行第0列开始,到第2行第1列结束,则该区域覆盖了6个物理单元格,但逻辑上它们属于同一个值。

using NPOI.HSSF.UserModel;
using NPOI.SS.UserModel;
using System;
class Program {
static void Main() {
// 假设文件存在且包含合并单元格
using var fs = new FileStream("data.xlsx", FileMode.Open, FileAccess.Read);
var wb = new XSSFWorkbook(fs);
var sheet = wb.GetSheetAt(0);
int count = sheet.NumMergedRegions;
for (int i = 0; i < count; i++) {
var region = sheet.GetMergedRegion(i);
Console.WriteLine($"Region {i}: Rows [{region.FirstRow}, {region.LastRow}], Cols [{region.FirstCol}, {region.LastCol}]");
}
}
}
如何在遍历时避免重复读取同一值
在逐行逐列遍历单元格时,必须维护一个状态来标记哪些单元格已经被作为“主单元格”处理过。通常的做法是在遍历到某个单元格时,检查它是否是所在合并区域的左上角(即 row == region.FirstRow && col == region.FirstCol)。如果是,则读取并存储该值;如果不是,则忽略该单元格,因为它的值与左上角单元格相同。

using NPOI.HSSF.UserModel;
using NPOI.SS.UserModel;
using System;
using System.Collections.Generic;
class Program {
static void Main() {
using var fs = new FileStream("data.xlsx", FileMode.Open, FileAccess.Read);
var wb = new XSSFWorkbook(fs);
var sheet = wb.GetSheetAt(0);
var mergedRegions = new List<ICellRange>();
for (int i = 0; i < sheet.NumMergedRegions; i++) {
var region = sheet.GetMergedRegion(i);
mergedRegions.Add(new CellRange(region.FirstRow, region.LastRow, region.FirstCol, region.LastCol));
}
int lastRow = sheet.LastRowNum;
for (int r = 0; r <= lastRow; r++) {
var row = sheet.GetRow(r);
if (row == null) continue;
int lastCol = row.LastCellNum;
for (int c = 0; c < lastCol; c++) {
var cell = row.GetCell(c);
if (cell == null) continue;
bool isMainCell = false;
foreach (var region in mergedRegions) {
if (r >= region.StartRow && r <= region.EndRow &&
c >= region.StartCol && c <= region.EndCol) {
if (r == region.StartRow && c == region.StartCol) {
isMainCell = true;
} else {
// 非主单元格,跳过
goto NextCell;
}
}
}
if (isMainCell) {
Console.WriteLine($"Value at ({r},{c}): {cell.StringCellValue}");
}
NextCell: ;
}
}
}
}
struct CellRange {
public int StartRow, EndRow, StartCol, EndCol;
public CellRange(int sR, int eR, int sC, int eC) {
StartRow = sR; EndRow = eR; StartCol = sC; EndCol = eC;
}
}
当合并单元格跨越空行时如何处理索引偏移
如果Excel文件中存在完全空的行,XSSFSheet 的 GetRow() 可能会返回 null,这会导致基于物理行号的逻辑判断出现偏差。此时应依赖 MergedRegion 提供的绝对坐标进行判断,而不是依赖当前遍历到的行对象是否存在。只要 MergedRegion 中记录的 FirstRow 等属性是准确的,即使中间有空行,左上角单元格的定位依然准确。建议在读取前先将所有合并区域加载到内存列表中,并在遍历时优先匹配列表而非依赖行的连续性。


















