如何将 CSV 转换为 JSON 格式

先了解输入与转换方式

CSV 转 JSON 工具适合把表格型文本整理成 JSON，便于后续查看、传递或继续处理。你可以提供 CSV 文本，并按输入内容选择字段分隔符、是否把首行作为表头，以及 JSON 输出的缩进方式。工具支持逗号分隔和分号分隔的内容。

将 CSV 文本转换为 JSON

1. 准备一段 CSV 文本，并将其粘贴到输入区域。不要提交空白或只包含空格的内容，因为这类输入会被拒绝。
2. 选择与文本一致的字段分隔符。逗号是默认选项；如果每列之间使用分号，请改用分号。
3. 根据首行内容决定表头处理方式。首行包含列名时，保留表头处理；如果文本没有可用的表头，则关闭该设置，让各行按行值处理。
4. 设置 JSON 缩进。未特别调整时使用默认的 2 个空格，也可以选择其他缩进设置。
5. 提交转换，并查看生成的 JSON 格式结果。若 CSV 解析过程中出现异常，转换会以失败结果结束，而不会生成 JSON 输出。

如何理解转换结果

启用表头处理时，字段数量与首行一致的记录会按“表头: 单元格内容”组织为键值记录；表头和单元格文本两侧的空白会被去除。字段数量与首行不一致的行不会按表头键值记录处理，而会保留为行值。

因此，看到键值记录通常表示该行的字段数量与表头匹配；看到行值形式，则需要检查该行是否少列或多列。若结果失败，先检查输入是否为空白，以及分隔符是否与原始 CSV 一致，再检查文本是否能被正常解析。

使用示例

你要把包含姓名和年龄两列的简短 CSV 文本整理成 JSON，以便检查每行是否与表头对应。

将 name,age 和一行包含两个字段的内容粘贴到输入区域，保留逗号分隔符与首行表头处理，然后提交转换。

输入包含表头和匹配字段的行时，结果呈现为由表头与对应单元格组成的键值记录；如果某行字段数量不同，该行呈现为行值。

使用限制

• 空白或只含空格的 CSV 不会成功转换；如果解析过程出现异常，也不会返回 JSON 输出。

常见错误

• 如果分隔符选错，字段数量可能无法与表头对应，结果会出现行值而不是预期的键值记录。请按原始 CSV 实际使用的逗号或分号重新选择分隔符。

常见问题

没有表头的 CSV 可以转换吗？

可以，但要在表头处理中关闭“首行作为表头”的设置；关闭后，各行不会按首行列名组织。

分号分隔的 CSV 能转换吗？

可以。分隔符默认是逗号，使用分号分隔字段时请选择分号。

为什么部分结果没有显示为键值记录？

如果某行的字段数量与表头不同，该行会保留为行值，而不是转换成表头键值记录；请检查该行是否缺少或多出字段。