Zod

Zod 是一个以 TypeScript 优先的模式声明与运行时数据校验库,开发者通过链式 API 定义数据的结构和约束,既能在运行时校验数据,又能由同一份模式自动推断出静态类型。

概述

Zod 由科林·麦克唐纳(Colin McDonnell)开发,近年在前端与 Node.js 社区广泛流行。TypeScript 的类型只在编译期存在,无法保证运行时收到的数据真的符合预期,例如来自接口或表单的外部输入。Zod 让开发者只写一次模式,就同时获得运行时校验能力和对应的 TS 类型,避免了类型定义与校验逻辑重复且容易脱节的问题。

核心特点

• 单一来源:一份模式同时产出运行时校验与静态类型,二者始终一致。
• 类型推断:无需手写接口,类型可从模式自动推断。
• 链式组合:通过链式方法描述可选、默认值、范围、正则等约束。
• 可组合:模式可嵌套、组合与复用,支持对象、数组、联合等复杂结构。
• 友好报错:校验失败时提供结构化的错误信息,便于定位与提示。

应用场景

Zod 常用于校验接口返回数据、解析表单输入、验证环境变量与配置,以及在全栈框架中约束前后端之间的数据契约。它也常与表单库配合,把校验规则与类型统一到一处管理。

常见问题

问:有了 TypeScript 类型,为什么还需要 Zod?答:TS 类型在运行时被擦除,无法校验真实数据。对来自网络或用户的外部输入,仍需运行时校验,Zod 正是弥补这一空缺。

问:Zod 只能在 TypeScript 项目里用吗?答:不是。它在纯 JavaScript 中也能做运行时校验,只是配合 TypeScript 使用时类型推断的收益最大。