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?
支持 网页。
