推荐使用CsvHelper库处理CSV文件,它轻量高效、支持复杂场景;通过NuGet安装,可自动映射类属性与CSV列名,读写简洁安全,并提供编码、分隔符、头行等灵活配置。

处理 CSV 文件最推荐的方式是使用 CsvHelper —— 一个轻量、高性能、社区活跃的开源库,专为 .NET 设计,能轻松应对复杂 CSV 场景(如带引号、换行、不同编码、自定义分隔符等),远比手动用 string.Split 或 TextFieldParser 更安全可靠。
安装 CsvHelper
通过 NuGet 安装最新稳定版:
- 在 Visual Studio 的“包管理器控制台”中运行:
Install-Package CsvHelper - 或使用 .NET CLI:
dotnet add package CsvHelper - 项目 SDK 格式(.csproj)中直接添加:
(版本号以 NuGet 页面 为准)
读取 CSV 到对象列表(推荐方式)
定义与 CSV 列名/顺序匹配的 C# 类,CsvHelper 可自动映射:
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
public DateTime BirthDate { get; set; }
}读取示例(支持 UTF-8、BOM 自动识别):
using (var reader = new StreamReader("people.csv"))
using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
{
var records = csv.GetRecords().ToList();
// records 已是 Person 对象集合,无需手动解析字段
} 注意:
• 默认按属性名匹配 CSV 头(Header)列名,大小写不敏感
• 若列名不一致,可用 [Name("Full_Name")] 或配置 ClassMap
• 遇到空值或格式错误时,可启用 csv.Configuration.MissingFieldFound = null; 并捕获 CsvReaderException
写入对象列表到 CSV
同样简洁:
var people = new List{ new Person { Name = "张三", Age = 28, BirthDate = new DateTime(1996, 5, 12) }, new Person { Name = "李四", Age = 31, BirthDate = new DateTime(1993, 8, 4) } }; using (var writer = new StreamWriter("output.csv")) using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture)) { csv.WriteRecords(people); }
默认生成带 Header 的 CSV;如需禁用 Header,设置:csv.Configuration.ShouldWriteHeaders = false;
处理常见问题的小技巧
-
中文乱码? 确保
StreamReader指定正确编码,例如:new StreamReader("data.csv", Encoding.UTF8)(Windows 记事本保存的 CSV 常含 BOM,UTF8 编码通常能自动识别) -
分隔符不是逗号? 修改配置:
csv.Configuration.Delimiter = "\t"; // 制表符csv.Configuration.Delimiter = ";"; // 中文分号(注意编码) -
跳过前几行(如说明行)?
csv.Read(); // 读一行丢弃csv.Read(); // 再读一行丢弃 -
验证某列必填? 在类中加
[Required]并配合csv.Configuration.HeaderValidated += (header, context) => { ... };
基本上就这些。CsvHelper 把 CSV 当作结构化数据来对待,而不是纯文本——写法清晰、扩展性强、出错有提示。只要模型对得上,读写两行代码搞定,不复杂但容易忽略配置细节。










