easyexcel横向合并单元格

### EasyExcel 实现横向合并单元格

在使用 EasyExcel 库时，可以通过自定义 `MergeStrategy` 来实现横向合并单元格的效果。具体来说，在数据模型类中加入特定字段用于控制哪些列应该被合并，并通过编写相应的逻辑来完成这一操作。

对于横向合并的需求，通常是在导出表格前先遍历待写入的数据集合，找到连续相同值所在的行号范围并记录下来；之后利用这些信息创建对应的区域对象传递给 EasyExcel 的 API 完成实际的合并动作[^1]。

下面是一个简单的例子展示如何实现这一点：

// 数据VO类
public class HorizontalMergeData {
    @ExcelProperty("姓名")
    private String name;
    
    @ExcelProperty("部门")
    private String department;

    // getter and setter methods...
}

// 自定义合并策略接口实现
public class CustomHorizontalMergeStrategy implements MergeStrategy {

    /**
     * 判断是否需要合并当前单元格与其他单元格.
     */
    @Override
    public boolean isNeedToMerge(int sheetNo, int rowIndex, int columnIndex, List<List<CellRangeAddress>> mergeRegions) {
        // 这里可以根据业务需求调整判断条件
        return true; // 假设我们总是希望水平方向上的重复项能够被合并
    }

    /**
     * 获取要合并的Cell地址区间.
     */
    @Override
    public CellRangeAddress getMergedRegion(List<Object> data, int relativeRowIndex, int absoluteColumnIndex) {
        Object currentValue = ((Map<String,Object>)data.get(relativeRowIndex)).get("name");
        
        int startRow = relativeRowIndex;
        while (relativeRowIndex + 1 < data.size() && Objects.equals(currentValue,
                ((Map<String,Object>)data.get(relativeRowIndex + 1)).get("name"))) {
            ++relativeRowIndex;
        }
        return new CellRangeAddress(startRow, relativeRowIndex, absoluteColumnIndex, absoluteColumnIndex);
    }
}

为了确保空白单元格也能参与合并，可以在 VO 类中的相应属性设置默认为空字符串 `" "` ，这样即使某些单元格看起来是空的也会被认为是有效的内容从而允许它们之间发生合并行为[^3]。

最后一步就是在调用 EasyExcel 导出方法的时候传入上述提到过的自定义合并策略实例即可达到预期目的。