如何用EPPlus导出含子对象的Excel？求替代库

嗨，我之前在使用EPPlus导出带嵌套子对象的数据时也卡过壳，给你分享几个实用的解决方案，以及一些更适合处理这类场景的替代库：

一、在EPPlus中处理嵌套对象的办法 #

EPPlus本身确实对泛型嵌套对象的支持不够友好，不过我们可以通过手动或自动扁平化的方式来解决：

1. 手动创建扁平集合（简单场景首选） #

如果你的对象结构不复杂，直接用LINQ生成一个匿名类型的扁平集合是最直接的方式。比如你有一个包含Address子对象的User类：

public class User {
    public int Id { get; set; }
    public string Name { get; set; }
    public Address Address { get; set; }
}

public class Address {
    public string Street { get; set; }
    public string City { get; set; }
}

可以这样转换后导出：

var users = GetUsers(); // 你的原始数据集合
var flattenedUsers = users.Select(u => new {
    u.Id,
    u.Name,
    街道 = u.Address.Street,
    城市 = u.Address.City
});

using var package = new ExcelPackage();
var worksheet = package.Workbook.Worksheets.Add("用户数据");
worksheet.Cells["A1"].LoadFromCollection(flattenedUsers, true); // true表示包含表头
package.SaveAs(new FileInfo("用户数据.xlsx"));

2. 用反射自动扁平化（复杂场景通用） #

如果对象层级多、结构复杂，可以写一个通用的反射工具类，递归遍历所有嵌套属性，生成扁平的键值对集合，再转换成DataTable或者匿名类型给EPPlus使用。比如写一个扩展方法：

public static IEnumerable<Dictionary<string, object>> Flatten(this object obj, string parentPrefix = "") {
    var result = new Dictionary<string, object>();
    foreach (var prop in obj.GetType().GetProperties()) {
        var propName = string.IsNullOrEmpty(parentPrefix) ? prop.Name : $"{parentPrefix}_{prop.Name}";
        var value = prop.GetValue(obj);
        if (value != null && !prop.PropertyType.IsValueType && prop.PropertyType != typeof(string)) {
            // 递归处理子对象
            var childFlattened = value.Flatten(propName);
            foreach (var child in childFlattened) {
                foreach (var kvp in child)
                    result.Add(kvp.Key, kvp.Value);
            }
        } else {
            result.Add(propName, value ?? DBNull.Value);
        }
    }
    return new List<Dictionary<string, object>> { result };
}

然后把集合转换成DataTable，再用EPPlus的LoadFromDataTable方法导出：

// 先实现一个Dictionary转DataTable的扩展方法
public static DataTable ToDataTable(this IEnumerable<Dictionary<string, object>> data) {
    var table = new DataTable();
    if (!data.Any()) return table;
    
    foreach (var key in data.First().Keys)
        table.Columns.Add(key);
    
    foreach (var row in data)
        table.Rows.Add(row.Values.ToArray());
    
    return table;
}

// 导出逻辑
var flattenedData = users.SelectMany(u => u.Flatten()).ToDataTable();
worksheet.Cells["A1"].LoadFromDataTable(flattenedData, true);

二、适合处理嵌套对象的替代库 #

如果觉得EPPlus的处理方式太麻烦，可以试试这些对嵌套对象更友好的库：

• ClosedXML：语法和EPPlus类似，但原生支持泛型嵌套对象的导出，甚至可以通过配置自定义列名和嵌套属性的展开方式，上手成本低，社区活跃。
• NPOI：老牌的开源Excel库，灵活性极高，虽然需要手动处理单元格写入，但完全能控制每一个嵌套属性的导出逻辑，稳定可靠，适合复杂场景。
• Syncfusion Excel Library：功能非常强大，支持自动导出复杂的嵌套对象、集合甚至是实体框架的关联数据，有免费的社区版可以使用，文档也很完善。
• ExcelDataReader + ExcelDataWriter：轻量级组合，适合快速读写Excel，处理嵌套对象时可以自己映射属性，体积小，性能不错。

内容的提问来源于stack exchange，提问作者Muds