Zod

zod.dev

TypeScript 优先的数据校验库,用 schema 声明数据结构并自动推导静态类型,零依赖、核心包 gzip 后约 2kb,内置与 JSON Schema 互转,适合在接口响应、表单提交和环境变量处确认运行时数据形状的开发者。

打开官网 本站 11 月 22 日 实测可以打开
最近 4 次实测

4 次可以打开平均 3.1 秒

本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。
zod.devZod 首页截图

zod.dev 首页 · 本站实拍 · 点开看大图

Zod 是一个 TypeScript 优先的校验库。你用它声明一份 schema,描述数据应该长什么样——从单个字符串到多层嵌套对象——然后拿这份 schema 去解析外部来的数据。解析通过的结果既经过校验,也带着推导出的 TypeScript 类型,后面直接使用不必再写类型断言。

典型写法是先定义 z.object({ name: z.string() }),再对接口返回、表单提交或配置文件调用 parse。数据不合规时抛错,合规时返回类型安全的值。

主要特点

  • 零外部依赖,Node.js 和现代浏览器都能跑
  • 核心包 gzip 后约 2kb
  • API 不可变,每次调用返回新实例
  • 同时支持 TypeScript 和纯 JavaScript
  • 内置与 JSON Schema 的相互转换
  • 周边生态较广,表单集成、API 库、Mock 工具都有现成适配

安装与要求

通过 npm install zod 安装,也可以在 jsr.io 上以 @zod/zod 获取。官方测试覆盖 TypeScript v5.5 及以后版本,更老的版本可能可用但不在支持范围内。使用前需要在 tsconfig.json 里打开 strict 模式。文档还提供了 MCP server 和 llms.txt,方便让 AI 代理检索用法。

适合谁

写 TypeScript 的前端和后端开发者。凡是需要在运行时确认数据形状的地方都用得上:接口响应、表单输入、环境变量、配置文件。项目里已经在用 tRPC 或 React Hook Form 的话,两者都直接支持 Zod schema,接入成本更低。

常见问题

Zod 收费吗?
Zod 免费使用。
用 Zod 要登录吗?
不用登录就能用。
Zod 有哪些平台 / App?
支持 网页。

同在「框架、库与开源项目」全部 920 个 →

打开官网