Zod

用 TypeScript 声明一次结构,同时得到运行时校验。

简介

类型优先的数据校验库,用一套 schema 同时推导静态类型并在运行时验证输入,适合表单、接口边界和环境变量等不可信数据入口。

安装

npm install zod

命令用于快速开始,具体版本与配置请以官方文档为准。

适用场景

  • 校验表单提交的输入结构
  • 为接口请求和响应定义共享 schema
  • 在启动时检查环境变量是否完整

特点

  • 从 schema 自动推导 TypeScript 类型
  • 校验失败时能提供结构化错误路径
  • 组合式 API 方便复用字段规则

专属示例

真实运行

结构校验与错误路径

Zod 用 safeParse 校验嵌套表单,逐个字段展示真实的 issue 路径与错误码。

打开示例