CsvHelper是C#生态最可靠CSV库，适合结构化读写；string.Split(',')无法处理引号包裹、换行、转义等RFC 4180规则，必致解析错误。
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）
Knowledge Graph - Csv Graph Loader Generator
下载
从 CSV 数据集生成图数据库加载器和三元组映射。将表格 CSV 数据转换为图数据库可直接使用的节点、边和三元组。
关键点在于：必须用 StreamReader/StreamWriter 包一层，并显式传入 Encoding；CsvHelper 自己不处理编码。
- 读取示例（映射到类）：
using (var reader = new StreamReader("data.csv", Encoding.UTF8)) using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture)) { var records = csv.GetRecords<MyModel>().ToList(); } - 写入示例：
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 就跑，等上线后才发现某几条脏数据让整个批处理崩掉。
