用途:帮助开发者用 Zod 构建类型安全的 schema 定义与校验逻辑,适用于 API 输入、表单、环境变量等场景。
主要能力:掌握基础类型(string、number、object、array、record)、类型推断 z.infer、复杂校验(.refine、.superRefine)、数据转换(.transform)、以及 React Hook Form、Next.js API Routes/App Router Actions、tRPC 和环境变量集成。
使用方式:定义 schema 后用 parse 或 safeParse 解析;safeParse 返回结果对象,无需 try/catch,并可通过 error.format() 或 flatten() 提取可序列化错误。可用 z.coerce 处理 FormData 或 URL 查询参数,用 z.setErrorMap 定制全局错误信息。
适用场景:表单校验、服务端 Action 输入校验、环境变量 fail-fast 校验、跨字段校验(如密码确认)、输入数据转换(字符串转日期或数字)。
限制与注意:.optional() 只允许 undefined,不处理空字符串;z.coerce.boolean() 对 "false"/"off" 等字符串转换可能不符合预期;对象级 refine 需传 path 才能把错误挂到正确字段;递归 schema 建议用 z.lazy 并显式定义基础类型。更新 schema 若字段约束不同,应单独定义而非仅用 .partial()。
资料未提供该技能的安装命令、收费方式或具体平台支持细节。