一句话答案
对比JSON Schema结果要固定输入、格式和参数,只改一个变量。 JSON Schema 是运行时契约,TS 是编译期类型;二者可互转但不完全等价。
为什么重要
同时改多个变量,结果无法归因。
Schema 能描述 required/format。
具体怎么做
- 先贴真实/完整的 JSON 示例,覆盖可选字段和空数组。
- 生成后检查数组元素、null/可选、嵌套对象。
- 设置根类型名,复制到项目。
- 正式项目补 Zod/Valibot 运行时校验。
- 为 API 变更加契约测试/版本。
常见错误
- 把示例当完整 schema,漏可选/空数组。
- 直接相信生成的 any/null 联合。
- 属性名含空格/中文忘了引号。
- 生成后不做运行时校验。
检查清单
- JSON 示例覆盖可选/空数组/null。
- 数组对象字段已合并。
- 属性名/根名合法。
- 已补运行时校验。
- API 契约/版本已考虑。
关键事实
- Schema 能描述 required/format。
- TS 不生成运行时校验。
常见问题
两次JSON Schema结果怎么对比?
对比JSON Schema结果要固定输入、格式和参数,只改一个变量。 JSON Schema 是运行时契约,TS 是编译期类型;二者可互转但不完全等价。
检测要多久?
通常 1–3 分钟;如果问题间歇出现,连续测 30 秒并换环境复测。
会上传数据吗?
本页在浏览器本地运行,不上传画面/声音;扩展仍可能读取页面。
来源: JSON Schema