使用CsvHelper.Excel.Core(v27.2.7)无法覆写Excel导出的日期格式

核心原因 #

在CsvHelper 27.2.7版本中，属性上的[Format]特性优先级高于全局TypeConverterOptionsCache配置。当属性标记了[Format]特性时，写入数据时会优先使用特性定义的格式，完全忽略你通过全局缓存设置的格式规则——这是CsvHelper的设计逻辑，局部属性配置会覆盖全局默认配置。

可行解决方案 #

不用复制整个映射类，只需通过ClassMap动态覆盖目标属性的格式即可，适配你有大量复杂映射的场景：

using (var writer = new ExcelWriter(destXlsx, CultureInfo.InvariantCulture))
{
    // 创建默认映射，自动继承原有属性的映射规则
    var classMap = new DefaultClassMap<MyFormat>();
    classMap.AutoMap(CultureInfo.InvariantCulture);
    
    // 单独覆盖Date属性的格式
    classMap.Map(m => m.Date).TypeConverterOption.Format("dd/MM/yy");
    
    // 注册自定义映射
    writer.Context.RegisterClassMap(classMap);
    
    writer.WriteHeader<MyFormat>();
    writer.NextRecord();
    writer.WriteRecords(MyRecordsInMyFormat);
}

为什么之前的尝试无效？ #

你调用writer.Context.TypeConverterOptionsCache.GetOptions<DateTime>()或AddOptions()设置的是全局DateTime类型的默认格式，但CsvHelper在处理带有[Format]特性的属性时，会直接读取特性中的配置，跳过全局默认规则。只有当属性没有标记任何格式特性时，全局配置才会生效。

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