.ts · text/typescript

Zod 模式: Zod 运行时校验 Schema

Zod Schema 将运行时 JSON 解析校验(`z.object`、`z.array`、`.optional()`)与 `z.infer<typeof schema>` 静态 TypeScript 类型推导融为一体。

快速解答: Zod Schema 将运行时 JSON 解析校验(`z.object`、`z.array`、`.optional()`)与 `z.infer<typeof schema>` 静态 TypeScript 类型推导融为一体。 API 边界运行时载荷校验、tRPC/React Hook Form 表单验证以及单一数据源 TS 类型推导。

结构类型强类型代码
人类可读性高
支持嵌套支持
LLM Token 效率中
文件扩展名.ts
MIME 类型text/typescript
适用场景API 边界运行时载荷校验、tRPC/React Hook Form 表单验证以及单一数据源 TS 类型推导。

核心优势

  • 在运行时拦截非法 JSON 输入,同时自动推导出配套的 TypeScript 类型
  • 第一时间定位缺失字段、类型漂移等问题并给出明确错误提示
  • 支持 .strict() 严格模式,可主动拒绝接口中的未知多余字段

局限与权衡

  • 相比编译后完全擦除的 TS 接口会引入少量运行时库体积
  • 深层递归数据结构仍需额外显式补充类型标注
  • 若上游 API 常新增无害字段,过于严格的 .strict() 模式可能引发兼容性报错

参考资料

本地转换与清理 Zod 模式

相关工程指南

Zod 模式 常见问题

为什么除了 TypeScript 接口还需要生成 Zod Schema?

TypeScript 类型在运行期并不存在,而 Zod 能在运行期校验真实传入的 JSON 数据并自动导出 z.infer<typeof schema>。

JSON 转 Zod 中的“严格对象模式”会有什么作用?

它会在生成的 z.object(...) 上附加 .strict(),遇到未定义的额外字段时直接抛错而非静默忽略。

嵌套对象和混合类型数组能自动推导吗?

可以。嵌套结构会准确生成嵌套的 z.object()、z.array()、z.union() 以及 .nullable() / .optional() 修饰器。