若依框架Excel导出进阶：基于注解的跨列动态行合并策略实现-CSDN博客

1. 为什么我们需要跨列动态行合并？

在若依前后端分离项目中做报表导出，相信很多朋友都遇到过这样的场景：导出一份订单明细，同一个订单号下有多条商品记录，我们希望“订单号”这一列只显示一次，后面的“订单金额”、“下单日期”等列也能跟着合并起来，这样报表看起来才清爽、专业。但若依框架自带的Excel导出功能，虽然强大，却只支持简单的单列合并，遇到这种需要以某一列为基准，动态合并其他多列的需求，就有点力不从心了。

我最早遇到这个问题是在做一个销售数据看板的时候。业务方要求导出的Excel里，同一个销售员的业绩数据要合并显示。如果只用基础的合并，销售员名字是合并了，但他的“销售额”、“订单数”、“客户数”这几列数据还是分散在多行，看起来非常杂乱，业务方每次都要手动调整，抱怨连连。这时候，一个能够基于注解配置、实现跨列动态合并的方案就显得至关重要了。

这种需求在业务系统中非常普遍，比如：

订单汇总报表：以订单ID为准，合并客户信息、总金额、下单时间。
人员信息统计：以部门为准，合并部门下的多项统计指标。
层级数据展示：比如树形结构的数据，希望父级节点信息在合并行中只显示一次。

原始的若依ExcelUtil类，其合并逻辑是内嵌且相对固定的，扩展性不强。如果我们每遇到一种新的合并需求就去硬编码修改工具类，代码会变得难以维护。因此，一个理想的解决方案是：将合并规则“外置”到注解上，让实体类的字段自己声明“我需要根据哪个基准列进行合并”。这样，不同的导出需求只需要调整实体类的注解配置即可，无需反复修改核心工具类，真正做到灵活、可配置。接下来，我们就一步步看看如何实现这个进阶功能。

2. 核心改造：为Excel注解添加合并能力

要实现注解驱动的合并，第一步就是扩展若依框架的@Excel注解。框架原有的注解已经包含了丰富的导出控制信息，比如列名、类型、顺序等，我们只需要为其增加一个用于指定合并规则的属性。

2.1 理解原有的@Excel注解

在动手之前，我们先快速回顾一下若依的@Excel注解。它通常标注在实体类的字段上，用来定义该字段在Excel中的行为。例如：

public class OrderVO {
    @Excel(name = "订单编号", sort = 1)
    private String orderNo;
    
    @Excel(name = "商品名称", sort = 2)
    private String productName;
    
    @Excel(name = "金额", sort = 3)
    private BigDecimal amount;
}

这个注解控制了导出的列标题、顺序、格式等。但原生的注解并没有任何关于“行合并”的字段。

2.2 新增mergeLine属性

我们的目标是：在@Excel注解中增加一个mergeLine属性。这个属性的值是一个字符串，用来指定当前字段应该根据哪一列（基准列）的值进行合并。更具体地说，它存储的是基准列的索引号。

为什么是索引号而不是字段名？因为在Excel合并的逻辑处理中，我们操作的是单元格的列索引（从0开始），这比解析字段名更直接高效。当然，在注解配置时，我们需要手动计算或知晓目标基准列的索引位置。

修改后的@Excel注解定义（在com.ruoyi.common.annotation包下）需要新增这个属性：

public @interface Excel {
    // ... 其他原有属性 ...
    
    /**
     * 合并行配置（拓展属性）
     * 例如：`mergeLine = "0"` 表示此列的值需要根据第0列（索引）的值相同与否进行行合并。
     * 支持配置多个基准列索引，用英文逗号分隔，但通常一个字段只参照一个基准列。
     * 注意：此功能需要配套的ExcelUtil工具类支持。
     */
    String mergeLine() default "";
}