# 从 JSON 样本与电子表格推导 JSON Schema

从代表性的 JSON 样本或 XLSX 行数据生成可审阅的 JSON Schema 草案，再检查类型、必填性、空值和异常值，确认后才用于后续契约工作。

> 标准页面: https://elysiatools.com/zh/hubs/json-schema-inference-from-samples-and-spreadsheets

- **关键词:** JSON Schema 推导, 从 JSON 样本生成 Schema, XLSX 转 JSON Schema, 必填字段审阅, 可空字段分析

## 常见问题

### 推导出的 schema 能自动成为生产契约吗？

不能。它只是根据观测样本整理出的结构化提案。采用前必须由契约负责人审阅业务必填性、兼容性、空值政策、格式和特殊值。

### 应该准备多少样本？

样本应覆盖正常变化、缺失字段、null、空集合、边界值和已知异常。数量本身不是目标，关键是样本有代表性且来源可追溯。

### JSON 样本和 XLSX 工作表不一致怎么办？

不要静默合并冲突。先映射字段名，确认它们是否属于不同版本或业务对象，再为每个决定记录来源优先级。

### 工具能准确识别日期和标识符吗？

工具可以根据观测值提出类型或约束建议，但日期格式、数字标识符、代码和前导零仍需结合业务规则人工检查。

## 相关内容

- [JSON Schema 与 API 契约校验工具](https://elysiatools.com/zh/hubs/json-validate): 在一个专题中比较 JSON Schema 校验、OpenAPI 响应检查、变异测试、压力测试和破坏性变更检测工具，适合 API 契约审查流程。
- [JSON 到强类型代码生成器](https://elysiatools.com/zh/hubs/json-to-typed-code-generators): 从 JSON 或 schema 证据生成 TypeScript、Go、Rust、Kotlin、Java、C# 与 Zod 校验模型。