← 全部指南

结构化数据 / 使用指南

拿到一段 JSON,怎样确认它能用?

从双引号、逗号到数字精度,用一个小例子走完校验与排错过程。

打开 JSON 格式化与校验 ↗

先分清语法正确和内容正确

JSON 用来表达对象、数组、字符串、数字、布尔值和 null。把一段内容粘贴到工具里,校验通过只说明它符合 JSON 语法,并不表示字段齐全、数据真实,或符合某个接口的要求。例如 {"age":"18"} 是合法 JSON,但 age 是字符串;如果接收方要求数字,这份数据仍然不能直接提交。

处理 AI 生成的结构化结果时,建议分两步:先检查能否解析,再对照接收方的字段定义检查名称、类型和允许值。格式化是阅读辅助,不能代替业务规则校验。

跟着一个例子检查层级

点击工具中的“载入示例”,你会看到 project 和 steps 两个字段。project 对应字符串,steps 对应数组。选择“格式化”后,大括号表示对象,方括号表示数组,每一级缩进两个空格。缩进不会改变字段值,主要帮助你看清一个值属于哪个字段。

如果真实数据里出现多个 items,先沿着外层对象找到目标字段,再检查数组中的每一项。不要只凭字段名称在整段文本里替换,否则可能改到不同层级里意义不同的值。

常见错误,按这个顺序排查

第一步检查引号。JSON 的字段名和字符串必须使用英文双引号,单引号和中文弯引号都不能直接代替。字符串内部的双引号要写成 \",反斜杠本身要写成 \\。

第二步检查逗号。两个字段或数组项之间需要逗号,但最后一项后面不能留逗号。第三步检查特殊值:JSON 不接受 undefined、NaN、Infinity,也不接受 JavaScript 注释。缺少数据时是否使用 null,应由数据约定决定,不要为了通过校验随意补值。

错误提示通常指向解析器停止的位置,真正的问题可能在它前面。先看报错附近是否少了引号或括号,再逐层缩小范围。可以复制出一个最小对象复现错误,但不要直接删改唯一的原始数据。

格式化也有边界

本工具使用浏览器的 JSON.parse 和 JSON.stringify。解析后重新输出可能改变数字写法和对象键的排列;包含重复键的对象会保留后一个同名键。因此,这个工具不适合对数字签名文本、精确字节内容或有重复键的数据进行无损处理。

超过 JavaScript 安全整数范围的数字可能丢失精度。工具会拒绝直接格式化绝对值超过 9007199254740991 的整数字面量;涉及大整数 ID 时,应按接口约定使用字符串,不能为了看起来整齐就把字符串改成数字。小数和指数形式仍受 JavaScript 数值精度限制。

在发送数据之前

先保留原文,再复制格式化结果到测试环境。检查字段类型、必填值、数组数量和编码是否符合对方约定。工具不会向服务器上传输入,也不会替你调用接口;复制按钮只会把结果写入剪贴板。刷新或关闭页面后,输入不会被本工具保存。

不要把真实密钥、客户资料或访问令牌放进公开的求助截图。即使处理发生在浏览器里,剪贴板管理器、浏览器扩展和你后续粘贴的应用仍可能读取这些内容。

标准与参考

本文围绕本站工具的实际行为编写。发现说明与结果不一致,可通过联系页面反馈,并附上不含敏感信息的最小示例。

继续阅读

拿到一段 JSON,怎样确认它能用? | 与 AI 共舞