C#怎么操作CSV文件_C# CsvHelper读写CSV文件方法教程【实战】-C#.Net教程-PHP中文网

CsvHelper是C#生态最可靠CSV库，适合结构化读写；string.Split(',')无法处理引号包裹、换行、转义等RFC 4180规则，必致解析错误。

c#怎么操作csv文件_c# csvhelper读写csv文件方法教程【实战】

CsvHelper 是目前 C# 生态中处理 CSV 最可靠的选择，尤其适合结构化数据读写；直接用 string.Split(',') 或 StreamReader 逐行解析，在字段含逗号、换行、双引号时必然出错。

为什么不能用 `string.Split(',')` 解析 CSV

CSV 不是简单“按逗号切开”就能搞定的文本格式。真实数据里经常出现：

字段本身含逗号：比如 "John Doe, Jr.",35,"New York" —— 直接 Split(',') 会拆成 5 段，而非预期的 3 段
字段含换行符：CSV 允许字段用双引号包裹后内嵌 \r\n，StreamReader.ReadLine() 会提前截断
字段含双引号：如 "Bob ""The Builder""",28，需将两个连续双引号解析为一个字面量
编码不一致：UTF-8 with BOM、GBK、UTF-8 no BOM 混用时，StreamReader 默认编码可能读出乱码

这些都不是“加个 Trim('"') 就能修好”的问题，而是语法层面的解析失败。

`CsvReader` 和 `CsvWriter` 的基础用法

安装 NuGet 包：CsvHelper（注意不是 CsvHelper.Core 或旧版 CsvHelper.Portable）

关键点在于：必须用 StreamReader/StreamWriter 包一层，并显式传入 Encoding；CsvHelper 自己不处理编码。

Knowledge Graph - Csv Graph Loader Generator

从 CSV 数据集生成图数据库加载器和三元组映射。将表格 CSV 数据转换为图数据库可直接使用的节点、边和三元组。

下载

读取示例（映射到类）：

using (var reader = new StreamReader("data.csv", Encoding.UTF8))
using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
{
    var records = csv.GetRecords<mymodel>().ToList();
}</mymodel>

写入示例：

using (var writer = new StreamWriter("out.csv", false, Encoding.UTF8))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(records);
}

CultureInfo.InvariantCulture 是必须项：避免某些区域设置把小数点解析成逗号（如德语环境）

字段名匹配：用 `[Name]` 还是 `[Index]`

两种方式都能工作，但适用场景不同：

[Name("User ID")]：按 CSV 表头名称匹配，直观易维护；但大小写敏感，且表头含空格、括号、连字符时必须用它（例如列名是 "Created Date (UTC)"）
[Index(2)]：按列序号（从 0 开始）匹配，适合无表头或表头不稳定的情况；但一旦源 CSV 列顺序变动，就会 silently 错配字段
混用危险：同一个类里同时用 [Name] 和 [Index] 会导致行为不可预测，官方文档明确建议避免
如果 CSV 没有表头，初始化 CsvReader 时要加 csv.Configuration.HasHeaderRecord = false;

容易被忽略的坑：BOM、空行、尾部逗号

生产环境 CSV 常带 UTF-8 BOM（EF BB BF），而 CsvHelper 默认不跳过它，会导致首字段名开头多出乱码字符（如 "Name"）。解决方法：

读取时用 new StreamReader(path, Encoding.UTF8, true) —— 第三个参数 detectEncodingFromByteOrderMarks = true 会自动识别并跳过 BOM
空行默认会被跳过，但若某行只有逗号（如 ,,,），CsvHelper 仍会尝试解析为全 null 记录，需在 GetRecords() 后手动过滤
尾部多余逗号（如 "a","b",）会被解析为额外 null 字段，对应类属性若为非 nullable 类型（如 int）会抛 CsvHelperException，建议设为可空类型或配置 Configuration.ShouldSkipRecord = ...

真正麻烦的从来不是“怎么读进来”，而是“怎么确保每一条都按预期解析”。CsvHelper 提供了足够细的钩子（ReadingExceptionOccurred、ShouldSkipRecord、BadDataFound），但多数人只调 GetRecords 就跑，等上线后才发现某几条脏数据让整个批处理崩掉。