使用CsvHelper读取CSV时，如何忽略表头大小写匹配实体类？

嘿，这个问题我之前也碰到过，CsvHelper默认是区分大小写来匹配表头和实体属性的，要解决这个很简单，只需要调整一下它的配置就行：

核心修改思路 #

通过配置CsvConfiguration，在表头和实体属性匹配前统一转换大小写（比如都转成小写），这样就能忽略原始表头的大小写差异了。

修改后的完整代码 #

using System.Globalization;
using CsvHelper;

// 你的实体类不用改动
public class Import 
{ 
    public DateTime Date { get; set; } 
    public string Category { get; set; } 
}

// 读取CSV的代码修改如下
var reader = new StreamReader(@"你的CSV文件路径");
var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    // 关键配置：将读取到的表头转为小写，和实体属性名的小写形式匹配
    PrepareHeaderForMatch = (header, index) => header.ToLower(),
    // 可选：如果CSV存在多余列或缺失列不想抛出错误，可以添加这两个配置
    HeaderValidated = null,
    MissingFieldFound = null
};

using var csv = new CsvReader(reader, config);
var records = csv.GetRecords<Import>().ToList();

配置说明 #

• PrepareHeaderForMatch：这个委托会在表头和实体属性匹配前处理每个表头值，这里我们把它转成小写。CsvHelper内部会自动将实体类的属性名也转为小写来做匹配，这样不管CSV表头是date、Date还是DATE，都能和实体的Date属性对应上。
• HeaderValidated 和 MissingFieldFound：这两个是可选配置，如果你的CSV文件可能存在多余的列（没有对应的实体属性）或者某些列缺失，设置为null可以避免CsvHelper抛出验证异常。如果需要严格验证表头，可以去掉这两行。

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