如何使用CsvHelper将动态对象映射为CSV并对齐列头

问题出在CsvHelper默认会用第一个对象的属性作为列头集合，后续对象的额外属性会被追加到列末尾，缺失的属性则直接跳过，导致列不对齐。要实现统一列头+空值填充的效果，需要先收集所有对象的完整属性集，再指定CsvHelper按这个集合输出。

完整解决方案代码 #

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Dynamic;
using CsvHelper;
using CsvHelper.Configuration;

List<dynamic> list = new List<dynamic>();

dynamic dynamicObject = new ExpandoObject();
dynamicObject.Name = "Bob";
dynamicObject.Aug22 = "3 hours";
dynamicObject.Sept22 = "5 hours";
list.Add(dynamicObject);

dynamic dynamicObject2 = new ExpandoObject();
dynamicObject2.Name = "Jane";
dynamicObject2.Aug22 = "7 hours";
list.Add(dynamicObject2);

dynamic dynamicObject3 = new ExpandoObject();
dynamicObject3.Name = "Alex";
dynamicObject3.July22 = "7 hours";
dynamicObject3.Aug22 = "6 hours";
dynamicObject3.Sept22 = "16 hours";
list.Add(dynamicObject3);

// 1. 收集所有唯一属性，并按指定顺序排序
var allProperties = list
    .SelectMany(obj => ((IDictionary<string, object>)obj).Keys)
    .Distinct()
    .OrderBy(key =>
    {
        // 保证Name列在最前面
        if (key == "Name") return 0;
        // 月份列按时间顺序排序（MMMyy格式）
        if (DateTime.TryParseExact(key, "MMMyy", CultureInfo.InvariantCulture, DateTimeStyles.None, out var date))
        {
            return date.Ticks;
        }
        // 其他列放在最后
        return long.MaxValue;
    })
    .ToList();

// 2. 创建自定义映射，指定所有要输出的列
var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    // 确保缺失属性输出空字符串
    MissingFieldFound = null,
};

using (var csv = new CsvWriter(Console.Out, config))
{
    // 注册动态对象的列映射
    var classMap = new DefaultClassMap<ExpandoObject>();
    foreach (var prop in allProperties)
    {
        classMap.Map(prop).Name(prop);
    }
    csv.Context.RegisterClassMap(classMap);

    // 写入所有记录
    csv.WriteRecords(list);
}

关键步骤说明 #

1. 收集完整属性集：将每个ExpandoObject转成IDictionary<string, object>，遍历所有键去重，再排序保证列顺序符合预期（Name在前，月份按时间排序）。
2. 自定义列映射：通过DefaultClassMap指定所有要输出的列，强制CsvHelper按照这个列集合生成CSV，不管单个对象是否包含该属性。
3. 空值自动填充：CsvHelper会自动为对象缺失的属性输出空字符串，确保列对齐。

运行修改后的代码，就能得到你期望的CSV输出：

Name,July22,Aug22,Sept22
Bob,,3 hours,5 hours
Jane,,7 hours,
Alex,7 hours,6 hours,16 hours

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