npoi合并区域报重叠错误是因为addmergedregion采用“先注册、后写入”机制且不自动检测重叠，任意单元格相交即失败；必须提前统一计算所有cellrangeaddress（行列均从0起），并在创建任何行/单元格前完成注册，否则写入无效或抛异常。
用 NPOI 动态生成带复杂合并的 Excel 表头，核心不是“怎么写”，而是“怎么算”——合并区域必须提前规划好行列索引，不能边写边 merge，否则会抛 InvalidOperationException: Cannot add merged region to sheet because it overlaps with an existing merged region。
为什么 sheet.AddMergedRegion(new CellRangeAddress(...)) 会报重叠错误？
因为 NPOI 的合并区域是「先注册、后写入」，且不自动检测重叠。一旦两个 CellRangeAddress 范围有任意一个单元格相交（哪怕只交一个），就会直接失败。
- 常见误操作：循环中对同一列反复调用
AddMergedRegion，但起始行/结束行没严格错开 - 典型陷阱：表头含「跨列+跨行」嵌套结构（如“时间”纵向占3行、“商品A”横向占2列再纵向占2行），手动算错
firstRow/lastRow就必然重叠 - 注意：
AddMergedRegion不返回 bool，也不抛明确提示，只在后续写入时或保存时报错，调试成本高
CellRangeAddress 四个参数到底怎么填？
顺序固定为：firstRow、lastRow、firstColumn、lastColumn，全部从 0 开始计数（和数组下标一致）。
- 合并 A1:C1 →
new CellRangeAddress(0, 0, 0, 2) - 合并 B2:B5 →
new CellRangeAddress(1, 4, 1, 1) - 合并 D3:F4 →
new CellRangeAddress(2, 3, 3, 5) - 关键点：如果要合并「整块矩形」，
firstRow ≤ lastRow且firstColumn ≤ lastColumn必须成立，否则静默失败
动态表头合并必须预建「坐标映射表」
当列数/行数不确定（如按商品分组、按月份展开），硬编码 CellRangeAddress 不现实。正确做法是：先遍历数据结构，生成一个 List<cellrangeaddress></cellrangeaddress>，再统一注册。
- 示例场景：导出销售报表，表头第0行是“时间”，占第0列；第1–2行是商品名，每商品占2列，共 N 个商品 → 总列数 = 1 + 2×N
- 计算逻辑：
int timeCol = 0; sheet.AddMergedRegion(new CellRangeAddress(0, 2, timeCol, timeCol)); // 时间列纵向3行 <p>int goodsStartCol = 1; for (int i = 0; i </p>
- 务必在创建任何
IRow或ICell前完成所有AddMergedRegion调用，否则部分区域可能被跳过
合并后写入内容，只能往左上角单元格写
合并后的区域逻辑上是一个单元格，但物理上仍保留所有原始坐标。NPOI 只允许向 firstRow/firstColumn 对应的单元格写入值，其他位置写入无效（不报错，但内容不显示）。
- 例如
new CellRangeAddress(2, 4, 1, 3)合并后，只能对row[2].GetCell(1)赋值，row[3].GetCell(2)写入会被忽略 - 样式设置也一样：必须设在左上角单元格，再通过
cell.CellStyle = style应用，合并区域整体生效 - 如果业务要求“居中显示”，别依赖 Excel 自动居中，显式设置
style.Alignment = HorizontalAlignment.CENTER和style.VerticalAlignment = VerticalAlignment.CENTER
最易被忽略的一点：NPOI 的 AddMergedRegion 是「不可逆」操作，且不提供查询接口。一旦注册错误，只能重建 ISheet ——所以动态场景下，务必把坐标计算逻辑单独抽成方法，加单元测试验证边界值（如 0 商品、1 月份、空数据集）。
