Excelize库中SetSheetRow方法处理自定义结构体的正确用法

在使用Go语言的Excelize库进行Excel文件操作时，开发者经常会遇到需要将自定义结构体数据写入Excel表格的需求。本文将以一个典型场景为例，详细介绍如何正确使用SetSheetRow方法处理结构体数据。

问题背景

当开发者尝试直接将结构体切片传递给SetSheetRow方法时，会发现所有字段值都被合并写入单个单元格，而不是预期的分散到不同单元格中。例如：

type Val struct {
    Name string
    Age  int
    Text string
}

values := []Val{
    {"Вася", 8, "Кошка (британка) редкого окраса"},
    {"Маффин", 6, "Кот редкого шоколадного окраса"},
    {"еще данные", 3, "23а"},
}

err = f.SetSheetRow("Sheet2", "B1", &values)

上述代码会导致所有结构体字段被合并显示在B1单元格中，而非按字段分散到B1、C1、D1等单元格。

原因分析

SetSheetRow方法设计用于处理基本数据类型的切片（[]interface{}），而不是直接处理自定义结构体。当传入结构体切片时，Go会将其视为单一值而非可展开的字段集合。

解决方案

正确的做法是将结构体字段转换为[]interface{}类型后再传递给SetSheetRow方法：

for i, val := range values {
    cell, _ := excelize.JoinCellName("B", i+1)
    row := []interface{}{val.Name, val.Text, val.Age}
    if err = f.SetSheetRow("Sheet2", cell, &row); err != nil {
        fmt.Print(err)
        return
    }
}

实现原理

1. 遍历结构体切片：逐个处理每个结构体实例
2. 构建单元格位置：使用JoinCellName方法动态生成单元格引用
3. 创建接口切片：将结构体字段按顺序转换为[]interface{}
4. 写入行数据：通过SetSheetRow方法将数据写入指定位置

最佳实践建议

1. 字段顺序控制：确保结构体字段转换顺序与Excel列顺序一致
2. 错误处理：始终检查JoinCellName和SetSheetRow的返回错误
3. 性能优化：对于大数据量，考虑批量操作而非单行处理
4. 类型安全：在转换前验证字段类型，避免运行时错误

扩展应用

此方法同样适用于其他复杂数据结构到Excel的转换场景，只需遵循将数据展平为基本类型切片的思路即可。对于更复杂的嵌套结构，可以递归处理或实现自定义的转换函数。

通过掌握这一技巧，开发者可以灵活地将各种业务数据结构高效地导出到Excel文件中，满足各类报表生成需求。