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

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

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

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

安装 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 当作结构化数据来对待,而不是纯文本——写法清晰、扩展性强、出错有提示。只要模型对得上,读写两行代码搞定,不复杂但容易忽略配置细节。

以上就是C# 如何处理CSV文件 – 开源库CsvHelper入门的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1442711.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 19:19:19
下一篇 2025年12月17日 19:19:31

相关推荐

发表回复

登录后才能评论
关注微信