如何将CSV转换为JSON

CSV 看似只是个简单的表格，直到某个字段值中包含逗号。此时，同一份文件在电子表格软件中能正常打开，却可能在简易转换器中变成错乱的行。一次有用的转换与一份损坏的数据集之间的差别，通常就在于引号处理方式，以及对数据类型的明确决策。

基本映射规则

带表头行的 CSV 文件：

name,role,active
Ada,admin,true
Sam,editor,false

将转换为：

[
  { "name": "Ada", "role": "admin", "active": "true" },
  { "name": "Sam", "role": "editor", "active": "false" }
]

首行作为对象的键（key），其后每一行则对应一个对象。这就是整个转换模型。

请注意，active 字段值为字符串类型。CSV 本身没有类型系统，因此转换器不应擅自推断 "true" 是布尔值，也不应认为 "00123" 是数字。将所有值保留为字符串通常是更安全的做法，尤其适用于邮政编码、电话号码以及含前导零的 ID 等场景。

可靠的转换工作流程

1. 导出干净的 CSV。 删除标题行、合并单元格和公式。表头行必须是文件的第一行。
2. 选择分隔符。 逗号最常见；分号和制表符（Tab）则多见于特定区域设置下的导出文件。
3. 检查带引号的字段。 例如 "New York, NY" 这样的字段必须保持为单个值，不可被错误拆分为两个字段。
4. 将 ID 保留为字符串。 若工具强制将该值转为数字，前导零将会丢失。
5. 核对行数。 将生成的 JSON 数组长度与电子表格中实际数据行数进行比对。
6. 验证 JSON 格式。 转换器应输出合法的 JSON；若结果非法，很可能是因为输入中存在未闭合的引号。

CSV 转 JSON 工具可在浏览器中解析逗号、分号及制表符分隔的 CSV 文件，且无需上传文件。

CSV 不擅长表达的内容

• 嵌套结构。 单元格内若包含 JSON，可将其整体作为字符串保留，但不会自动展开解析。
• 多层表头。 转换前需先将其扁平化为单层表头。
• 公式。 应导出计算后的值，而非公式本身。
• 日期与时区。 同一日期可能以字符串、序列号或本地化格式呈现。建议在转换前统一标准化。
• 超大文件。 浏览器标签页存在内存限制；请将大型导出文件拆分为多个批次处理。

何时应选用其他工具

如需编辑数据，请使用电子表格软件；如需查询数据，请将其导入数据库；如需定义 JSON Schema，请基于转换后的输出进行校验，而非假设原始 CSV 本身已足够规范。

对于已存在的 JSON 数据，JSON 格式化工具 是更合适的首选；而对于网页元数据，则推荐使用 Meta 标签生成器，它专用于生成另一类结构化输出。

简明要点

将 CSV 行转为对象，所有字段值均保留为字符串，并重点检查带引号的逗号及总行数。若转换过程在未提示的情况下悄然更改了 ID 或错误拆分了地址字段，那么再快的转换也毫无实用价值。