csvreader构造函数不接受文件路径，因其设计上仅支持textreader接口实例，编译时即报错；必须用streamreader（显式指定encoding.utf8和cultureinfo.invariantculture）包装文件流。
为什么CsvReader构造函数不接受文件路径
CsvReader设计上只接受TextReader，不是字符串路径——这是编译时就报错的硬限制。常见错误是写成new CsvReader("data.csv")，直接过不了编译。必须手动构造StreamReader并传入，否则连第一步都走不通。
关键点在于控制编码和流生命周期：StreamReader要显式指定Encoding.UTF8（尤其含中文时），且不能用File.OpenText()这种默认Encoding.Default的方式，否则BOM头或中文字段全乱。
- 正确写法：
using var reader = new StreamReader("data.csv", Encoding.UTF8); using var csv = new CsvReader(reader, CultureInfo.InvariantCulture); - 别在
CsvReader构造里塞File.ReadAllText()，那会把整个文件加载进内存，大文件直接OOM -
CultureInfo.InvariantCulture必须传，否则数字、日期格式可能因系统区域设置崩掉
GetRecords()和Read()的区别在哪
GetRecords<t>()</t>是一次性把整块流转成强类型集合，内部会缓存所有行再映射，适合小文件或需要随机访问的场景；但对GB级CSV，它等于把全部数据塞进内存+反复GC，性能断崖下跌。
真正流式处理靠的是csv.Read() + csv.GetField()组合：每次只解析当前行，字段按需取，内存占用恒定在KB级。
- 用
while (csv.Read()) { var name = csv.GetField("name"); ... }，而不是foreach (var r in csv.GetRecords<person>())</person> - 如果CSV没标题行，得先调
csv.Read()跳过第一行，或构造时传new CsvConfiguration { HasHeaderRecord = false } -
GetField(int index)比GetField(string name)快，但可读性差；字段名查表有开销，大文件建议用索引
遇到MalformedLineException怎么定位
这个异常90%不是数据真坏了，而是配置没对上RFC 4180规则。比如字段含逗号却没加双引号包裹，或末尾多逗号a,b,c,,，CsvHelper默认会严格校验并炸掉。
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
解决方向不是“跳过错误行”，而是提前声明容忍策略：
- 允许空字段：
new CsvConfiguration { BadDataFound = null }（设为null表示忽略） - 跳过非法行不抛异常：
BadDataFound = (args) => { /* 记日志，不throw */ } - 字段内换行符必须被双引号包裹，否则
CsvHelper认为是记录断裂——检查原始CSV是否符合规范，别指望库自动修复 - 如果首行是BOM导致
HeaderRecord识别失败，确保StreamReader已用Encoding.UTF8构造，BOM会被自动剥离
大文件写入时AutoFlush为什么必须开
写CSV时用StreamWriter默认带缓冲，几MB数据才刷一次磁盘。大文件导出中途崩溃，最后几百KB就丢了——这不是bug，是设计如此。
AutoFlush = true让每调一次WriteField()或NextRecord()都立即落盘，代价是I/O变多，但数据安全可控。
- 写法：
using var writer = new StreamWriter("out.csv") { AutoFlush = true }; - 别用
File.WriteAllText()拼接字符串再写，字符串拼接本身就会吃光内存 - 如果目标是追加写，用
new StreamWriter("out.csv", true)，但同样要设AutoFlush = true
真正难的不是读完一行，而是当某列突然出现200个嵌套引号+换行+逗号时，你得清楚此刻CsvHelper正在状态机哪一步，以及BadDataFound回调里该打什么日志才能让下游排查时不骂你。
