C# 如何处理CSV文件 - 开源库CsvHelper入门

来源：这里教程网时间：2026-02-21 17:32:38 作者：

处理 CSV 文件最推荐的方式是使用 CsvHelper —— 一个轻量、高性能、社区活跃的开源库，专为 .NET 设计，能轻松应对复杂 CSV 场景（如带引号、换行、不同编码、自定义分隔符等），远比手动用

string.Split

或

TextFieldParser

更安全可靠。

安装 CsvHelper

通过 NuGet 安装最新稳定版：

在 Visual Studio 的“包管理器控制台”中运行：
Install-Package CsvHelper
或使用 .NET CLI：
dotnet add package CsvHelper
项目 SDK 格式（.csproj）中直接添加：
<packagereference include="CsvHelper" version="33.0.1"></packagereference>
（版本号以 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<Person>().ToList();
    // records 已是 Person 对象集合，无需手动解析字段
}

注意：
• 默认按属性名匹配 CSV 头（Header）列名，大小写不敏感
• 若列名不一致，可用

[Name("Full_Name")]

或配置

ClassMap

• 遇到空值或格式错误时，可启用

csv.Configuration.MissingFieldFound = null;

并捕获

CsvReaderException

写入对象列表到 CSV

同样简洁：

var people = new List<Person>
{
    new Person { Name = "张三", Age = 28, BirthDate = new DateTime(1996, 5, 12) },
    new Person { Name = "李四", Age = 31, BirthDate = new DateTime(1993, 8, 4) }
};
<p>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 当作结构化数据来对待，而不是纯文本——写法清晰、扩展性强、出错有提示。只要模型对得上，读写两行代码搞定，不复杂但容易忽略配置细节。