- 首页
- FormatOwl 博客
- 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 新工具、功能改进与使用指南。


