API · 数据 · 本地工具

接口样例从 CSV 转为 JSON 后怎样核对

检查列名、前导零、空值、多行单元格与反向转换边界,用正常和异常样例确认数据能否交给下游接口。

从表格导出的编号 001、开关 true 和空单元格,不会自动告诉接口它们应是什么类型。转换完成后,先核对数据含义,再决定怎样传给下游。以下记录是虚构的接口样例,不包含真实用户数据。

先转换一份保留原值的样例

打开 CSV / JSON 转换,粘贴:

sku,enabled,note
001,true,"含逗号,与换行
第二行"
002,,

选择 CSV → JSON,点击“转为 JSON”,结果应有两条记录。检查第一条的 sku 是字符串 "001",enabled 是字符串 "true";note 是包含换行的一个字段,不应多出一条记录。第二条的 enabled 和 note 都是空字符串。

本站工具将 CSV 值保留为字符串,不猜测数字、布尔值或日期。逗号和换行包在双引号内;字段自身含双引号时用两个双引号表达。格式依据为 RFC 4180(复核于 2026-09-20);实际导出器的分隔符和编码仍需核对,本工具不是任意表格文件导入器。

用接口约束解释结果

先列出每列的业务含义。例如 sku 是保留前导零的标识,enabled 可能需要显式映射为布尔值,空字符串可能应被拒绝、保留或转为 null。不要直接把任意非空文字转成 true;"false" 也是非空字符串。

将转换结果放进 JSON 格式化检查结构,再按你的接口 schema 或测试夹具核对必填项和类型。本站转换器不做业务类型转换,也不会把结果发送到接口。

表头或列数有问题时停止转换

下面的示例第二行多了一列:

sku,enabled
001,true,extra

工具应提示表头、字段数或引号问题。先查原始导出内容,确认逗号是分隔符还是单元格内容;不要直接删除最后一列以让错误消失。重复表头、空表头和未闭合引号也需要回到来源修正。

反向转换并不保留所有 JSON 信息

先选择 JSON → CSV。JSON 转 CSV 只接受非空的顶层对象数组,字段顺序按首次出现排列。下面带嵌套对象的输入会被拒绝:

[{"sku":"001","meta":{"language":"zh-CN"}}]

应先由业务决定展开字段还是保留原 JSON,不能让工具擅自拼接嵌套值。另外,null、缺失字段与空字符串转成 CSV 后都可能成为空单元格,再转回来无法区分原意。这一往返不应被描述为无损迁移。

反向转换前核对数字与重复键

使用合成输入 [{"id":9007199254740993}] 时,工具会提示整数超出安全范围,不生成改变了编号的 CSV。[{"id":"9007199254740993"}] 则可导出原编号;这个带引号版本只适用于接口契约本来就允许字符串的情形。CSV 转 JSON 仍按字符串保存单元格,因此同一长编号不会被自动解析成数值。

同一对象内重复键、负零、溢出数值和转换后十进制数值会改变的输入也会被拒绝。普通 0.1 与 0.10 可以处理,但尾零、指数写法不保证保留。拒绝后保留原文,核对数据来源与契约,必要时改用文本对比;不要为消除报错直接删除字段或更改类型。JSON 数值范围和重复键的互操作性边界见 RFC 8259 第 4、6 节(复核于 2026-09-20;本站转换行为于 2026-09-20 验证)。

练习:三种空值往返后还分得清吗

下面是另一组虚构输入,只用于核对空值规则:

[{"sku":"001","note":null},{"sku":"002"},{"sku":"003","note":""}]

粘贴到 CSV / JSON 转换,选择 JSON → CSV,应得到表头 sku、note 和三条记录,三个 note 单元格都为空。复制该 CSV 回到输入区,改选 CSV → JSON,再点击“转为 JSON”:三个 note 都成为空字符串。把原始 JSON 与往返后的 JSON 放进 JSON 对比,预期看到两处差异:$[0].note 从 null 变为空字符串,$[1].note 从缺失变为新增空字符串;第三条的空字符串没有变化。

如果下游业务需要区分这三种状态,这个往返已经不适用,应保留原 JSON 并停止用 CSV 传递这些状态。不要凭行数和编号未变就认为内容完整,也不要直接把全部空单元格改为 null。

在排查记录中填写:操作为“核对 CSV 往返后的备注空值”;实际观察为“三条记录保留,但两处 note 语义发生变化”;下一步为“核对下游是否区分 null、缺失和空字符串,区别重要时保留原 JSON”。“尚未确认”可以记录下游的空值契约,“已做修改”写明仅完成合成样例转换。生成 Markdown 后即可带走本次结论;这一步没有向真实接口提交数据。

留下复查记录

输入上限为 512 KiB。转换前后记录行数、列名、标识是否保留前导零、空值规则,以及至少一条含逗号或换行的记录。下载 JSON 后按上述清单抽样;修正来源数据后再次转换,并用 JSON 对比查看预期字段变化。

需要继续排查请求时,进入接口数据与配置排查;浏览器跨域失败则按 CORS 预检失败的定位方法检查请求和响应证据。

切换方向会保留原文,并停用旧结果的复制和下载。核对方向后再处理;“填入示例”会在覆盖前要求确认。配置文件转换可继续阅读 JSON 与 YAML 转换后怎样核对类型和注释。