如何将 CSV 文本转换为 JSON

先确认 CSV 的结构

CSV 是按行和列组织的文本数据。使用这个工具时，你可以把 CSV 内容作为文本提供，再将解析出的行整理为 JSON 格式的扁平记录。默认设置适合第一行包含列名的情况；如果每一行都只是数据，也可以改用不保留表头的处理方式。

完成 CSV 到 JSON 的转换

先整理 CSV 文本。若第一行是列名，请让后面的行分别对应数据记录，并检查逗号、引号及各列之间的关系。
2. 将整理好的内容粘贴到输入控件中。没有内容或只输入空白也能执行，但这种输入不会生成记录。
3. 根据第一行的用途调整表头设置。第一行是字段名时，保留默认的表头映射；第一行也是数据时，关闭表头映射，使解析出的每一行都按数据处理。
4. 按阅读需要设置 JSON 缩进。缩进使用数字，默认值为 2；它改变的是输出排版，不改变记录内容。
5. 执行转换后，同时查看 JSON 结果和记录数。若输入有多行，检查第一行是否被正确处理，再核对字段名、字段顺序和每条记录的内容。

从记录数和结构检查结果

判断结果时，先用记录数确认解析出的记录规模，再阅读 JSON 数组中的对象。采用默认表头映射时，多行输入的第一行会提供后续记录的字段名；若这行其实是数据，输出结构就会偏离预期。关闭表头映射后，第一行不再承担字段名的作用，每个解析行都会作为数据处理。

空白输入对应空 JSON 数组，记录数为 0。若处理过程出现异常，操作仍可能显示为成功，但结果会是空数组、记录数 0，并附带错误说明，所以需要把错误说明也纳入检查。这个转换适合把表格行整理为扁平记录，不能据此期待生成嵌套对象。

使用示例

你有一条包含姓名和城市的 CSV 数据，希望将它整理成便于读取的 JSON 记录。

提供两行 CSV 文本：第一行写入 name,city，第二行写入 Li Wei,Beijing；保留默认表头映射，将缩进设为 2 后执行转换。

结果形状为一个 JSON 数组，数组内有 1 个对象；对象使用 name 和 city 作为字段名，并显示记录数 1。

使用限制

输入范围是作为文本提供的 CSV，结果按行和单元格整理为扁平 JSON 记录；这项转换不应被当作嵌套对象构建工具。

常见错误

第一行并非列名却保留了默认表头映射，会让它被用作字段名；请确认首行用途，并在首行是数据时关闭表头映射后重新转换。

常见问题

能否直接把 Excel 工作簿作为输入？

当前输入方式是提供 CSV 文本；如果数据位于 Excel 工作簿中，请先取得相应的 CSV 文本内容，再按本文方式处理。

第一行会被当作表头吗？

当输入超过一行时，默认会把第一行用作字段名，后续各行转换为记录；若首行也是数据，请先关闭表头映射。

转换后能看到记录数量吗？

转换结果会提供生成的记录数，空白内容显示为 0；发生处理异常时，也会返回 0 和错误说明，因此应同时核对结果结构。