CSV解析列数突增的根本原因是默认工具不识别双引号包裹规则，导致字段内逗号被误作分隔符；须用csv.QUOTE_MINIMAL并预处理全角引号，Excel需通过导入向导启用引号限定符，shell工具应替换为csvkit或Python解析。
CSV解析时列数突然变多，csv.reader 把字段内逗号当分隔符了
根本原因是：csv规范允许字段用双引号包裹，里面可以含逗号、换行甚至引号本身；但默认的 csv.reader（python）或多数命令行工具（如 awk）根本不识别这个规则，直接按逗号切——只要某列内容是 "smith, john"，它就拆成两列。
实操建议：
- Python 必须显式启用引号处理：
csv.reader(f, quotechar='"', quoting=csv.QUOTE_MINIMAL)——QUOTE_MINIMAL是关键，它只在必要时（含逗号/换行/引号）才要求引号，兼容大多数导出场景 - 别用
quoting=csv.QUOTE_NONE，哪怕你“确定没引号”，因为一旦遇到含逗号的字段，立刻崩 - 如果源文件引号是中文全角
“”，csv模块完全不认——必须先用.replace('“', '"').replace('”', '"')预处理
Excel 打开 CSV 后列错位，但用文本编辑器看明明有双引号
这不是解析问题，是 Excel 的自动导入逻辑在作祟：它会跳过 BOM、忽略引号、按第一个非空行猜分隔符——哪怕你文件里每行都严格用 "a,b","c" 包裹，Excel 仍可能把 a,b 当两列。
实操建议：
- 绝对不要双击打开 CSV 文件 —— 改用 Excel 的「数据 → 从文本/CSV」导入向导，手动选「分隔符号」→ 勾选「引号作为文本限定符」
- 确保文件保存为 UTF-8 with BOM（不是纯 UTF-8），否则 Excel 可能乱码，连带引号识别失败
- 如果字段本身含双引号（如
"He said ""Hi""），必须是两个连续双引号，且整个字段被双引号包裹；单个未转义的"会导致后续全部错位
sed 或 awk 处理含逗号 CSV 时彻底失效
这些工具本质是按行正则匹配，没有 CSV 解析能力。遇到 "addr, city",2023，awk -F',' '{print }' 输出的是 "addr，不是完整地址。
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
实操建议：
- 别硬刚：用
csvkit（in2csv/csvsql）或 Python 脚本替代——它们底层调用标准 CSV 解析器 - 如果非要用 shell，临时方案是先用 Python 提取字段再交给
awk：python3 -c "import csv,sys;[print(row[0]) for row in csv.reader(sys.stdin)]" - 注意
csvkit默认把空字段读作None，而csv.reader返回空字符串''，逻辑判断时行为不同
字段含换行符 + 双引号，csv.reader 还是报 Error: new-line character seen in unquoted field
错误信息直指核心：换行符出现在未被引号包裹的字段里。CSV 规范要求——只要字段含换行符，就必须用双引号包裹，否则解析器无法判断该换行是字段内还是记录结束。
实操建议：
- 检查报错行前后：是否漏了开头或结尾的
"？比如写成"name,age\n"123,45（少一个引号），就会触发此错 - 生成 CSV 时，用
csv.writer自动处理，别手拼字符串：writer.writerow(['line1\nline2', 'ok'])会自动生成"line1\nline2",ok - 若必须手拼，记住规则：含换行、逗号、引号三者任一，就必须
"包裹，且内部引号要翻倍，如"He said ""Yes""\nand left"
最常被忽略的一点：双引号不是“可选美化”，而是 CSV 结构的语法基石——缺一个引号，后面所有行的列对齐都会雪崩。别省那两个字符。
