CsvHelper 必须用 StreamReader + Encoding.UTF8 + CultureInfo.InvariantCulture 初始化，否则中文乱码或小数解析错误；GetRecords<T>() 需先 Read() 或设 HasHeaderRecord=false；字段映射需 [Name] 或 [Index] 特性；大文件应避免 ToList()。
CsvHelper 是目前 C# 读取 CSV 最稳妥的选择，但直接 new CsvReader("path.csv") 必编译失败——它不接受路径字符串，必须配 StreamReader + 显式编码 + InvariantCulture。
为什么 new CsvReader("file.csv") 会报错
CsvReader 构造函数只接受 TextReader 实现类（如 StreamReader），不支持文件路径字符串。这是最常卡住新手的第一步。
- 错误写法：
new CsvReader("data.csv")→ 编译失败，提示“没有匹配的构造函数” - 正确写法：先用
StreamReader打开流，再传入：new CsvReader(reader, CultureInfo.InvariantCulture) - 漏掉
Encoding.UTF8会导致中文字段乱码（尤其 Windows 默认 ANSI 环境下读 UTF-8 文件） - 漏掉
CultureInfo.InvariantCulture会让德语/法语系统把3.14解析成0（因小数点被当成千位分隔符）
CsvHelper 读取时必须调用 csv.Read() 才能开始解析
GetRecords<T>() 是延迟执行的 IEnumerable，但首行默认被当作表头；如果没提前调用 csv.Read() 或没设 HasHeaderRecord = false，GetRecords 会跳过第一行数据。
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
- 有表头且想映射到类：保持默认即可，
csv.GetRecords<MyModel>()自动跳过第一行 - 无表头或表头在第 2 行：必须先
csv.Configuration.HasHeaderRecord = false，再手动csv.Read()跳过垃圾行 - 想读表头内容本身：调用
csv.ReadHeader()，然后用csv.HeaderRecord获取字符串数组 - 忘记
Read()就直接GetField(0)？返回空字符串或抛InvalidOperationException
字段名不匹配时所有属性都是默认值（0 / null）
CSV 列名是 "User ID"，C# 属性叫 UserId，默认不会自动映射——GetRecords<T>() 返回的对象里该字段全是 0 或 null，毫无报错提示。
- 用
[Name("User ID")]特性精准绑定，大小写敏感，支持空格和括号 - 用
[Index(0)]按列序号绑定，适合无表头或列顺序固定但名称不规范的场景 - 严禁混用：
[Name]和[Index]出现在同一个类里，CsvHelper 行为未定义，可能静默错配 - 调试技巧：临时加一行
Console.WriteLine(string.Join("|", csv.HeaderRecord));确认实际列名
大文件别用 GetRecords.ToList()，改用流式 Read + GetField
GetRecords<T>().ToList() 会一次性加载全部对象到内存，10MB CSV 可能生成上万实例，GC 压力陡增；而 Read() + GetField() 是真正的逐行流式处理。
- 需要强类型对象且内存够：用
GetRecords<T>()，配合using确保流释放 - 只取某几列、或要做条件过滤：用
while (csv.Read()) { var id = csv.GetField<int>(0); ... } - 字段含换行符？只要被双引号包裹，
CsvReader内部自动合并多行，不用额外处理 - 写入空集合时
WriteRecords()不生成表头——真要表头，得先调csv.WriteHeader<T>()
真正容易被忽略的是：CsvHelper 从不帮你猜编码，也从不帮你处理 BOM；哪怕你用记事本另存为 UTF-8，没显式传 Encoding.UTF8，StreamReader 就可能按系统默认编码读，首字符变乱码。这不是库的问题，是流和编码解耦的设计使然——你得亲手把这两件事串起来。
