用途:该技能确保代码库中一致使用 Zod v4 模式,防止误用 v3 语法。适用场景包括创建新校验 schema、用 React Hook Form 定义表单校验、编写 API 请求与响应校验器、将现有 schema 从 v3 升级,以及为校验器添加自定义错误信息。
主要能力与关键模式:错误定制由 v3 的 message、invalid_type_error、required_error 改为 error 参数,如 z.string({ error: "Custom error message" });字符串格式校验改为顶层函数 z.email()、z.uuid()、z.url(),替代 z.string().email() 等链式写法;对象严格性改用构造器 z.strictObject()、z.looseObject()、z.object(),替代 .strict()、.passthrough();schema 组合用 .extend() 替代 .merge();.default() 在验证后应用,默认值须匹配输出类型,验证前默认值用 .prefault();错误处理用 z.prettifyError() 或 z.treeifyError(),替代已弃用的 .format()、.flatten()、.formErrors。
使用方式:文档提供表单 schema、API 请求 schema、Server Action 校验及 React Hook Form 集成示例,使用 zodResolver 接入表单;TypeScript 类型通过 z.infer<typeof schema> 推断。
限制与说明:仅涉及 Zod v4 用法约定,不提供安装命令或版本号;部分内容标注为针对 kove-webapp 项目。分类标识依据其开发校验用途选择 coding。