由 JSON 生成 Zod 运行时校验 Schema
0 字节上传把 JSON 示例转为可靠的 Zod 运行时校验器(`z.object`、`z.union`、`.nullable()`)并同步导出 `z.infer` TS 类型。
或将文本或数据文件拖放至此 · Ctrl V 快速粘贴 · 或拖放 .json 文件 · Ctrl V 粘贴 JSON
- 100% 浏览器本地运行
- 同步导出 z.infer TS 类型
- 支持 .strict() 严格模式
实时转换前后预览
{
"eventId": "evt_991",
"attempt": 1,
"payload": {
"success": true,
"tags": ["billing"]
}
}import { z } from "zod";
export const rootSchema = z.object({
eventId: z.string(),
attempt: z.number(),
payload: z.object({
success: z.boolean(),
tags: z.array(z.string()),
}),
});
export type RootSchema = z.infer<typeof rootSchema>;源格式与目标格式规格对比: JSON → Zod 模式
| 规格属性 | 源格式:JSON | 目标格式:Zod 模式 |
|---|---|---|
| 结构类型 | 层级结构 | 强类型代码 |
| 人类可读性 | 高 | 高 |
| 支持嵌套 | 支持 | 支持 |
| LLM Token 效率 | 低 | 中 |
| 文件扩展名 | .json | .ts |
| MIME 类型 | application/json | text/typescript |
| 适用场景 | REST/GraphQL API 接口、结构化应用状态、NoSQL 文档以及跨系统数据交换。 | API 边界运行时载荷校验、tRPC/React Hook Form 表单验证以及单一数据源 TS 类型推导。 |
使用方法
如何在本地从 JSON 生成 Zod 校验 Schema
利用依据真实接口样本生成的 Zod Schema,牢牢守住 API 入口与表单数据的运行时安全边界。
- 粘贴 JSON 样本输入 Webhook 载荷、应用配置或 REST 接口返回的 JSON。
- 配置 Schema 生成选项设定 Schema 变量名、勾选导出 z.infer 类型,并按需启用 z.strictObject() / .strict()。
- 复制 Zod 模块代码直接粘贴到你的 TypeScript 服务或 tRPC 路由校验层中使用。
常见问题
常见问题解答
数组中某些元素缺失可选字段时 JSON 转 Zod 会如何处理?
只出现于部分元素中的字段会自动加上 .optional(),值为 null 的字段则会加上 .nullable()。
应该在生成的 Zod Schema 中开启“严格对象模式”吗?
在需要禁止未定义冗余键传入的严格契约场景建议开启;对接经常新增字段的外部 API 时保持关闭更稳妥。
生成的代码会同时包含 z.infer 推导的 TypeScript 类型吗?
会的。保持“导出 z.infer TypeScript 类型”开启即可在底部自动生成 export type ... = z.infer<typeof ...>。