JSON 格式化与校验:从语法检查到查询、比较和 CSV 导出
· 更新于

JSON 格式化与校验:从语法检查到查询、比较和 CSV 导出

整理 JSON,区分语法和 Schema 校验,检查嵌套数据、大整数与 CSV 字符串类型,减少接口排查中的误判。

接口响应挤成一行时,缺失字段和异常值很难发现。JSON 格式化可以整理缩进,但语法、数据结构和业务正确性仍然是三项独立检查。

FormatOwl 免登录在浏览器中格式化、压缩和校验 JSON。格式化会保留数字精度,不会重排对象键。

先确保输入是合法 JSON

{"items":[{"id":"0017","name":"Notebook","quantity":2}],"active":true}

选择格式化并设置缩进,可以看清对象和数组边界。需要紧凑输出时用压缩,只判断语法时用校验,不要把排版整齐当成内容正确的证明。

JSON 属性名需要双引号,不允许尾逗号和普通 JavaScript 注释,规则可参考 JSON 规范。从程序里复制的 JavaScript 对象字面量,可能需要有意识地修改才能成为合法 JSON。

按问题选择下一步

问题工具边界
语法是否成立格式化工具中的校验不检查应用业务规则
嵌套字段在哪里树形查看预览深度和节点数有限
哪些值符合路径JSONPath 查询返回匹配数组
两次响应有什么变化JSON 差异忽略对象键顺序,保留数组顺序
是否符合指定结构Schema 校验需要自包含 Schema

对上面的示例使用 $.items[*].name,可以选择商品名称。先确认简单路径,再查询大响应。查询、复制及导出免费使用,仍受输入大小限制。

留意编号类型和数字精度

如果 0017 的前导零有意义,应把它保存为字符串。数字与字符串即使在表格中看起来相似,也属于不同的 JSON 类型。

格式化、查询和差异比较会保留大数值,但 Schema 校验中的数字检查使用 JavaScript 数字,超出精度的值可能被舍入。不要假设整条处理流程里每个工具都以同样方式处理大整数。

转成表格或 CSV

JSON 表格查看接受对象数组,并根据键生成列。缺失值显示为空单元格,预览最多展示 200 行,完整 JSON 仍可获取。

需要 CSV 文件时用 JSON/CSV 转换,选择逗号、分号或制表符。CSV 转 JSON 后的值是字符串,交给要求明确类型的接口前要检查数字和布尔字段。

JSON 转 CSV 会保护可能被电子表格当成公式的单元格,因此字面表示可能变化。应在目标电子表格中检查,而不只是用文本编辑器比较外观。

替换原文件前检查差异

数组顺序变化会被视为变化,因为它可能具有业务意义。JSON 差异工具只比较,不负责合并。差异意外很多时,先检查数组排序和字段类型。

共享示例时去掉私人令牌和个人记录。本地处理表示数据运算在设备上执行,账户与导出校验仍会联系服务,详情见本地处理说明。

多 MB 导出使用大文件入口

普通格式化工具仍使用自身的输入限制。对于超过 10 MB 的 JSON,开发者工作台预览在 Pro 下提供最高 32 MiB 的文件导入、格式化与语法校验。处理在 Worker 中运行,可见预览限 16,000 个字符,完整结果通过专用复制和下载按钮获取。

打开大文件前可阅读大 JSON 指南。这项上限不会延伸到 JSONPath、CSV 转换或 Schema 校验。从小样本生成 Schema,也不同于按既有契约验证文档。

操作要点

格式化帮助阅读,校验应对应实际约束,编号类型要保留,导出结果要在目标环境核对。先从JSON 格式化开始,再按下一项问题选择工具。

FormatOwl 动态

好用的工具,实用的技巧

接收 FormatOwl 新工具、功能改进与使用指南。