C# 如何处理CSV文件 - 开源库CsvHelper入门-C#.Net教程-PHP中文网

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

幻夢星雲

发布： 2025-12-05 15:24:45

原创

255人浏览过

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

c# 如何处理csv文件 - 开源库csvhelper入门

处理 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

Docky AI

多合一AI浏览器助手，解答问题、绘制图片、阅读文档、强化搜索结果、辅助创作

查看详情

写入对象列表到 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) => { ... };