用途:该技能提供一套 Zod 模式校验模式,适用于 TypeScript 应用中对运行时数据进行校验,包括 API 响应、表单数据、环境变量等场景,并可通过 z.infer 自动推断 TypeScript 类型。
主要能力:覆盖基础模式(原始类型、对象)、复杂模式(数组、联合、可辨识联合、递归)、转换(transform、coerce、preprocess、默认值)、API 响应校验、React Hook Form 表单校验(zodResolver)、环境变量校验、自定义错误信息、可复用模式、extend/merge/pick/omit 等组合操作。使用 safeParse() 返回结果,可配合 error.format() 输出格式化错误。
使用方式:从 zod 导入 z 定义模式(如 z.string().min(2)、z.object({...})),用 z.infer 推断类型,通过 safeParse(data) 校验并判断 result.success;表单场景搭配 @hookform/resolvers/zod 的 zodResolver 与 react-hook-form 的 useForm 使用;环境变量场景用 safeParse(process.env) 校验后导出。
适用场景:API 响应校验、表单输入校验、环境变量校验及其他运行时数据校验。
最佳实践:使用 safeParse() 而非不带 try/catch 的 parse();模式定义放在单独文件;用 z.infer<> 生成类型;添加自定义错误信息。
限制:资料未提供安装命令、版本要求、性能数据及收费信息。