JSON 格式化 vs JSON 验证：区别是什么

核心区别：做什么不同

JSON 格式化（Formatter/Prettifier）：接收任意 JSON 输入，将其重新排版为缩进整齐、层次分明的可读格式，不改变数据内容，只改变呈现方式。前提是输入的 JSON 必须是语法正确的，否则格式化无法进行。

JSON 验证（Validator）：检查 JSON 是否符合语法规则（是否是合法的 JSON），或者检查 JSON 的结构和内容是否符合特定的 Schema 规范（更高级的业务逻辑验证）。验证的结果是"通过"或"失败+错误详情"，不改变数据。

两种验证层次

语法验证（Syntax Validation）：确认字符串是否是合法的 JSON——括号是否匹配、键名是否有引号、逗号位置是否正确等。这是最基础的验证，任何 JSON 解析器都会执行，一旦失败就会抛出解析错误。

Schema 验证（Schema Validation）：在语法正确的基础上，进一步验证 JSON 的结构和值是否符合预期的业务规则。例如：某个字段是否必须存在？某个数字字段是否必须大于 0？某个字符串是否必须符合邮箱格式？这种验证基于 JSON Schema 标准定义规则。

何时使用格式化工具

• 收到 API 响应数据，需要快速阅读和理解结构
• 配置文件手动编辑后，想统一整理格式
• 将 JSON 数据截图或粘贴到文档中分享
• 调试接口时想更清晰地查看请求/响应的数据结构
• 压缩的 JSON 数据需要转换为可读格式进行人工审查

何时使用验证工具

• 手动编辑了 JSON 配置文件，提交前检查语法是否有误
• 收到第三方 JSON 数据，在处理前验证其格式是否合规
• 开发 API 时，需要确保输入数据符合接口规范（JSON Schema 验证）
• 自动化测试中，验证 API 响应的 JSON 结构是否符合期望
• 排查"JSON 解析失败"错误时，找出具体的语法问题所在

大多数工具同时具备两种功能

实际上，优质的在线 JSON 格式化工具通常同时具备格式化和语法验证功能：当你输入 JSON 后，工具首先对其进行语法验证——如果有错误，显示错误信息；如果通过，则进行格式化展示。这两个步骤是自然串联的。

进一步的 JSON Schema 验证则通常是独立的功能，需要用户同时提供数据 JSON 和 Schema JSON，工具按照 Schema 规则验证数据是否合规，输出详细的验证报告。

JSON Schema 验证示例

假设你有一个用户注册 API，要求用户名长度 3-50 字符、年龄 18-120 之间、邮箱格式正确，对应的 JSON Schema 如下：

{
  "$schema": "http://json-schema.org/draft-07/schema",
  "type": "object",
  "required": ["username", "age", "email"],
  "properties": {
    "username": {
      "type": "string",
      "minLength": 3,
      "maxLength": 50
    },
    "age": {
      "type": "integer",
      "minimum": 18,
      "maximum": 120
    },
    "email": {
      "type": "string",
      "format": "email"
    }
  }
}

任何不符合上述规则的输入数据都会被 JSON Schema 验证器拒绝，并给出详细的错误说明，帮助 API 开发者快速发现数据问题。

实际工作流：格式化与验证的配合

在日常开发中，这两个工具的配合使用场景：开发 API 时，先用验证工具确认接口返回的 JSON 结构正确，再用格式化工具将其展示给团队成员审查；调试线上问题时，先用格式化工具将日志中的 JSON 变可读，再仔细检查各字段值是否符合预期；测试集成时，用 Schema 验证工具检查第三方 API 返回的数据是否符合合同规范。