格式化与验证有关联,但并不相同。格式化让解析后的文档更易读,语法验证解释为什么解析失败,Schema 验证则检查有效 JSON 是否具备应用期待的结构。
浏览器本地 JSON 格式化工具可以在不上传样本的情况下完成这三个阶段,适合处理可能包含内部或个人信息的接口 payload、配置片段、日志和生成数据。
先格式化文档
粘贴样本、选择统一缩进并执行格式化。成功输出说明所选解析器接受了输入。清晰的嵌套可以让缺失值、意外数组和放错位置的字段更容易被发现。
从第一个失败位置读取语法错误
解析器通常会在第一个无法继续理解的 token 附近停止。查看报错行列,再检查它之前的字符。常见原因包括尾逗号、单引号、注释、缺少结束括号、未转义换行,以及服务端返回了 HTML 错误页而不是 JSON。
单独验证数据契约
语法通过后,再用 JSON Schema 或应用规则检查必填字段、允许类型、字符串格式、数字范围和数组内容。格式化无法判断 email 是否缺失,或者 ID 类型是否错误。
保护敏感样本
优先选择在本地处理输入的工具,用 Network 面板确认行为,并删除调试不需要的秘密。即使流程在本地,也不应随意把生产令牌、密码、私钥和完整客户导出放进临时工具。
按接收系统要求导出
评审和版本控制适合使用格式化输出,需要更小体积时使用压缩输出。如果输入是 JSONC 或 JSON5,除非目标 API 明确接受宽松格式,否则应先转换为严格 JSON。
总结
可靠的 JSON 流程会分开处理可读性、语法和数据契约。先格式化,修复最早出现的语法错误,再验证 Schema,移除不必要的敏感字段,并导出目标系统需要的方言。