使用说明与限制
双向转换的操作步骤
- 选择“JSON → CSV”或“CSV → JSON”,再选择实际使用的分隔符:逗号、分号或制表符。制表符适合 TSV 文件,选择错误通常会表现为列数不对。
- 粘贴数据,或导入 UTF-8 文本文件。JSON 输入必须是对象数组;CSV 第一行必须是非空、互不重复的列名。
- 点击“处理”,核对结果后复制或下载。CSV/TSV 下载会带 UTF-8 BOM,方便 Excel、WPS 识别中文。
转换示例:编号与空值
[{"编号":"001","分数":98},{"编号":"002","分数":null}]以逗号导出时,结果为:
编号,分数
001,98
002,反向转换后,"001" 和 "98" 都保留为字符串,最后一个分数字段是空字符串,不会自动变回数字或 null。工具不猜测日期、身份证号或手机号类型;Excel 自身仍可能把编号识别成数字,需要在导入表格时指定文本列。
引号、嵌套对象与公式防护
- 字段内包含分隔符、换行或双引号时,会使用 CSV 引号规则;例如
他说"你好"会写成"他说""你好"""。不要通过简单地按逗号切割来校验这种文件。 - JSON 的所有字段名会合并为表头;缺少字段和
null都导出为空字段,无法仅靠 CSV 区分。嵌套对象、数组写成 JSON 字符串,反向转换不会自动还原嵌套结构。 - 默认开启公式防护:以空白加
=、+、-、@开头的字符串会加单引号;真正的数值负数不会因此被改写。防护会改变字符串,用于机器对接时需明确是否关闭。
遇到列数不一致怎么办?
先核对分隔符,再检查是否有未闭合的引号、未转义的双引号或缺少字段。完全空行会忽略,带引号的空值仍保留。最多支持 10000 条数据、200 列;大型表格请拆分。不要在电子表格中打开关闭防护后的不可信公式内容。
文本长度上限为 1,048,576 个 UTF-16 编码单元,约相当于同数量的常见中英文字符;emoji 可能占两个或更多单元。支持文件导入的工具另有 1 MiB 文件大小上限,文件需为 UTF-8 编码。