表头、分隔符与行

转换 CSV 前，先确认表格形状。

表头

当第一行是列名时，CSV 可以转换为 JSON 对象数组：

id,name
1,Ada
2,Grace

[
  { "id": "1", "name": "Ada" },
  { "id": "2", "name": "Grace" }
]

没有表头时，更安全的 JSON 形状是数组行，或使用自动生成的列名。自动列名适合调试，但通常不应作为最终 API 契约。

分隔符

不是所有表格文本都用逗号：

• 逗号：常见 CSV
• Tab：TSV 导出
• 分号：某些表格地区设置常见
• 竖线：日志和内部导出

自动检测很方便，但文件很小或结构模糊时，应手动选择分隔符。

行一致性

每一行都应有预期数量的字段。如果表头有五列，但某一行有六个值，通常意味着引号缺失、分隔符错误或粘贴片段损坏。

关键结论

表头定义对象 key，分隔符定义字段边界，行一致性帮助你避免静默丢数据。

使用 CSV 转换工具 的表格预览，在复制输出前确认结构。