什么是 JSON Schema？

JSON Schema 是一种基于 JSON 格式的规范，用于描述 JSON 数据的结构、约束和验证规则。它定义了 JSON 数据中每个字段的类型、格式、取值范围、是否必填等属性，广泛用于 API 文档、数据校验和自动化测试。

格式检测（format）是如何工作的？

工具通过正则表达式匹配样本数据中的字符串值，自动识别常见的格式模式。例如包含 @ 的字符串标记为 email，以 http(s):// 开头的标记为 uri，符合日期格式的标记为 date 等。注意这只是基于样本的推断，实际使用时可能需要人工校验。

Draft-07 和 2020-12 有什么区别？

Draft-07 是广泛使用的成熟版本，兼容性最好。2020-12 是最新版本，引入了 $defs 替代 definitions、prefixItems 替代 tuple validation、$dynamicRef 等新特性，规范更完善。新项目建议使用 2020-12，需要兼容旧工具则选择 Draft-07。

生成的 Schema 完全准确吗？

基于单个 JSON 样本推断的 Schema 是近似的。例如无法确定哪些字段是真正必填的（当前标记所有字段为 required），数组可能包含多种类型的元素（当前只分析了样本中的元素），数字范围也无法确定。建议将生成的 Schema 作为起点，根据实际业务需求进行调整。

JSON Schema Generator

Auto-generate JSON Schema from JSON

Schema 版本：允许额外属性检测格式模式检测必填字段

JSON 输入

Schema 输出

JSON Schema 生成器使用说明

主要功能

类型推断 - 自动识别 string、number、integer、boolean、null、array、object 类型
格式检测 - 自动识别 email、uri、date、date-time、uuid 等格式
必填检测 - 自动标记对象的所有字段为 required
多版本支持 - 支持 Draft-07 和 2020-12 规范
验证功能 - 验证原始 JSON 是否符合生成的 Schema

使用场景

API 接口文档自动生成
数据校验规则快速创建
前后端数据契约定义
配置文件格式规范
数据导入格式校验

JSON Schema Generator

JSON Schema 生成器使用说明

主要功能

使用场景

FAQ

Related Tools