由 JSON 生成 Zod 运行时校验 Schema

0 字节上传

把 JSON 示例转为可靠的 Zod 运行时校验器(`z.object`、`z.union`、`.nullable()`)并同步导出 `z.infer` TS 类型。

100% 客户端本地运行 — 可在 Network 面板验证 0 字节上传在 Network 面板确认 0 字节发送

或将文本或数据文件拖放至此 · Ctrl V 快速粘贴 · 或拖放 .json 文件 · Ctrl V 粘贴 JSON
  • 100% 浏览器本地运行
  • 同步导出 z.infer TS 类型
  • 支持 .strict() 严格模式

实时转换前后预览

转换前(输入)webhook.json
{
  "eventId": "evt_991",
  "attempt": 1,
  "payload": {
    "success": true,
    "tags": ["billing"]
  }
}
转换后(输出).ts
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/jsontext/typescript
适用场景REST/GraphQL API 接口、结构化应用状态、NoSQL 文档以及跨系统数据交换。API 边界运行时载荷校验、tRPC/React Hook Form 表单验证以及单一数据源 TS 类型推导。

使用方法

如何在本地从 JSON 生成 Zod 校验 Schema

利用依据真实接口样本生成的 Zod Schema,牢牢守住 API 入口与表单数据的运行时安全边界。

  1. 粘贴 JSON 样本输入 Webhook 载荷、应用配置或 REST 接口返回的 JSON。
  2. 配置 Schema 生成选项设定 Schema 变量名、勾选导出 z.infer 类型,并按需启用 z.strictObject() / .strict()。
  3. 复制 Zod 模块代码直接粘贴到你的 TypeScript 服务或 tRPC 路由校验层中使用。

常见问题

常见问题解答

数组中某些元素缺失可选字段时 JSON 转 Zod 会如何处理?

只出现于部分元素中的字段会自动加上 .optional(),值为 null 的字段则会加上 .nullable()。

应该在生成的 Zod Schema 中开启“严格对象模式”吗?

在需要禁止未定义冗余键传入的严格契约场景建议开启;对接经常新增字段的外部 API 时保持关闭更稳妥。

生成的代码会同时包含 z.infer 推导的 TypeScript 类型吗?

会的。保持“导出 z.infer TypeScript 类型”开启即可在底部自动生成 export type ... = z.infer<typeof ...>。