文档与 OCR实用指南

CSV 与 JSON 在线转换:检查引号、换行、空值和编号

CSV 用逗号分隔字段,但说明文字也可能包含逗号。JSON 支持嵌套结构,却不一定能直接变成二维表。先用两三条记录确认结构,通常比转换完一整份文件才发现错列更容易修复。

带引号的 CSV 字段与 JSON 对象数组双向转换的原创插画
原创示意图:KitNelo · 插画使用说明

先把问题解决

用 CSV / JSON 转换器 将带表头的 CSV 转成对象数组;反向操作要求非空的扁平对象数组。检查字段名称和行数,包含逗号、引号或换行的 CSV 字段应正确引用,编号用字符串表示。

CSV 的引号是结构,不是装饰

RFC 4180 的 CSV 格式说明 描述了引号字段及双引号转义。包含逗号或换行的字段需要整体引用,字段中的双引号用两个双引号表示;不要简单按每行和逗号拆分文本。

在工具中使用唯一且非空的表头,核对每条记录的列数。闭合引号或列数不正确时先修复输入,不要靠删掉所有引号解决。CSV 转 JSON 会按文本保留字段;这不表示系统自动判断日期和金额的业务含义。

虚构的单条转换示例

CSV 输入

name,id,note Ada,0007,"red, blue"

JSON 输出

[{"name":"Ada","id":"0007","note":"red, blue"}]

这里的逗号属于 note 字段,编号仍是字符串;用这个小样本检查转换后是否仍是一条记录。

JSON 转 CSV 前先确认二维结构

RFC 8259 的 JSON 说明 区分了对象、数组、字符串、数字和空值。这个转换入口只处理扁平对象数组,不会自动把嵌套对象或数组展开为新列。

例如 address 是一个对象时,先明确拆成 city 与 street 等列。各记录的字段并集会成为 CSV 表头,缺失字段和 null 输出为空单元格,因此 CSV 不能保留这两者的区别。

把 0007、长编号和账户代码明确存为字符串。已经在上游丢失的前导零不能通过转换可靠恢复,下载 CSV 后在 Excel 中也应按文本导入编号列。

转换后检查再交付

多份输入要汇总时,先阅读 按列名合并表格。需要生成文档时,再使用 Word 模板字段核对流程,不要把格式转换成功当作业务数据已经正确。

  1. 选两三条无敏感内容的记录,覆盖含逗号、换行、空值和编号的情况。
  2. 执行默认 CSV 转 JSON 或反向 JSON 转 CSV,检查记录数、列名和字段边界。
  3. 核对编号原文、换行与空值,再复制或下载实际结果。不要只检查预览的第一条记录。
  4. 如果修改输入,重新生成结果。共享设备使用敏感数据后,请清空可能保存在浏览器中的输入草稿。

常见问题

支持嵌套 JSON 吗?

这个入口的 JSON 转 CSV 不支持对象或数组字段值,需先将所需字段明确展开成列。

空值和缺失字段会保留区别吗?

不会。JSON 转 CSV 中 null 和缺失字段都变成空单元格;需要区别时应增加状态列。

可以直接上传 Excel 吗?

当前入口接收粘贴文本。Excel 文件可先在表格工具中导出 CSV,再核对并转换。

参考资料与延伸阅读

按步骤开始处理

进入对应工具,预览处理结果,检查导出的文件。

继续阅读