C#如何读取CSV文件_C#使用CsvHelper快速导入导出千万级数据【高性能】-C#.Net教程-PHP中文网

csvhelper是c#生产环境读取csv最可靠、可扩展性最强的选择，因其内置rfc 4180解析器，支持强类型映射、异步处理、自定义转换及流式迭代，而string.split(",")和textfieldparser均无法满足类型转换、空值策略等生产级需求。

c#如何读取csv文件_c#使用csvhelper快速导入导出千万级数据【高性能】

CsvHelper 是目前 C# 生产环境中读取 CSV 最可靠、可扩展性最强的选择，尤其适合结构固定、需强类型映射、或处理百万级以上数据的场景。它不是“能用”，而是“该用”——TextFieldParser 适合轻量解析，StreamReader + 手写逻辑适合调试或极简需求，但只要涉及类型转换、空值策略、异步流式处理、自定义字段映射，CsvHelper 就是事实标准。

为什么 CsvHelper 比 string.Split(",") 或 TextFieldParser 更适合生产？

因为 CSV 不是“用逗号切开就行”的文本，而是有 RFC 4180 规范的格式：字段含换行、引号嵌套、双引号转义（"" 表示一个 "）、BOM 头、混合编码、缺失字段等都会让简单分割崩掉。

string.Split(",") 在遇到 "张三,工程师" 这类字段时直接错位，且无法识别多行字段
TextFieldParser 能扛住规范，但不支持自动类型映射（比如把 "2026-04-20" 直接转成 DateTime），也不支持异步或配置化字段忽略
CsvHelper 内置完整 RFC 解析器，支持 GetRecord<t>()</t> 强类型绑定、GetRecords<t>()</t> 流式迭代、自定义 TypeConverter、文化信息控制、字段重命名、空字符串处理策略

CsvHelper 读取时必须设的三个配置项

不设这三项，90% 的导入会出隐性问题：字段错位、日期变 0001-01-01、数字变 0、中文乱码、首行被跳过。

csv.Configuration.HasHeaderRecord = true（默认为 true，但显式写出更安全；若无表头则必须设为 false 并手动调用 csv.ReadHeader()）
csv.Configuration.Encoding = Encoding.UTF8（必须显式指定，否则 BOM 文件可能被当 ANSI 读，中文全变问号）
csv.Configuration.MissingFieldFound = null（或设为委托忽略，否则字段数不匹配时直接抛 MissingFieldException）

示例初始化：

QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载

using (var reader = new StreamReader("data.csv", Encoding.UTF8))
using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
{
    csv.Configuration.HasHeaderRecord = true;
    csv.Configuration.Encoding = Encoding.UTF8;
    csv.Configuration.MissingFieldFound = null;
<pre class="brush:php;toolbar:false;">var records = csv.GetRecords<User>(); // 流式枚举，不全加载进内存
foreach (var u in records)
{
    Console.WriteLine(u.Name);
}

}

CsvHelper 中空字符串和 null 的默认行为

这是最容易踩坑的地方：默认情况下，CsvHelper 把 CSV 中的空字段（,,）映射为 null（对 string 类型），而不是空字符串 ""。如果你的模型字段是 string Name { get; set; }，而 CSV 里某行是 1001,,85，那么 u.Name 就是 null，不是 ""。

想让空字段变成 ""？加配置：csv.Configuration.ShouldUseConstructorParameters = false 不起作用；正确做法是注册自定义转换器：csv.Context.TypeConverterOptionsCache.AddOptions<string>(new TypeConverterOptions { NullValues = new[] { "" } });</string>
想让 int? 字段在 CSV 为空时为 null（而非报错），确保字段声明为可空类型，并且没配强制非空转换器
注意：字段名大小写必须与 CSV 表头完全一致（默认区分），否则映射失败返回默认值

千万级数据不 OOM 的关键：别用 ToList()

常见错误是写 var list = csv.GetRecords<user>().ToList()</user> —— 这会把全部记录一次性加载进内存，1000 万行轻松吃掉 2–3 GB。千万级数据唯一合理方式是流式消费。

用 foreach (var item in csv.GetRecords<user>())</user>，底层是逐行解析 + 即时映射，内存占用恒定
配合数据库批量插入时，每 1000 条做一次 SqlBulkCopy 或 EF Core ExecuteUpdate，避免单事务过大
如需并行处理（如校验+转换），先用 csv.Read() 跳过表头，再用 while (csv.Read()) + csv.GetRecord<user>()</user> 手动控制，比 GetRecords 更灵活

真正难的从来不是“怎么读进来”，而是“字段语义是否被准确还原”——比如 " 123 " 带空格要不要 Trim，"N/A" 算不算 null，日期格式是 yyyy-MM-dd 还是 d/M/yyyy。这些细节 CsvHelper 全都留了钩子，但得你主动去设。