SuperAPI AI 工具集

zod

编程与开发

查看项目

更新于 10-16 01:15

技能介绍

用途:在 TypeScript 应用中使用 Zod 编写模式校验时提供最佳实践指引,适用于新建 Zod 模式、在 parse() 与 safeParse() 间抉择、用 z.infer 做类型推断、处理校验错误反馈、组合复杂对象模式、使用 refine 与 transform,以及优化包体积和校验性能。

主要能力:包含 43 条规则,按 8 类优先级组织。1. 模式定义(关键):正确使用原始类型、用 z.unknown() 而非 z.any()、避免滥用 optional、在定义处应用字符串校验、固定值用 enum、表单/查询数据用强制转换。2. 解析与校验(关键):用户输入用 safeParse()、异步 refine 用 parseAsync、处理全部问题而非首个、在系统边界尽早校验、避免重复校验、不信任 JSON.parse 结果。3. 类型推断(高):用 z.infer 代替手写类型、区分 z.input 与 z.infer、同时导出模式与推断类型、品牌类型、开启严格模式。4. 错误处理(高):自定义错误消息、用 flatten() 展示表单错误、用 issue.path 定位嵌套错误、错误国际化、refine 中返回 false 而非抛错。5. 对象模式(中高):strict() 与 strip() 取舍、partial() 用于更新模式、pick()/omit() 生成变体、extend() 组合、optional() 与 nullable() 区别、可辨识联合类型。6. 模式组合(中):抽取共享模式、intersection() 组合、z.lazy() 递归、preprocess() 归一化、pipe() 多阶段校验。7. 改进与转换(中):refine() 与 superRefine() 选择、transform()/refine()/coerce() 区分、为改进错误加 path、default() 默认值、catch() 容错解析。8. 性能与包体积(低中):缓存模式实例、对体积敏感的应用用 Zod Mini、避免热路径动态创建模式、懒加载大型模式、优化大数组校验。

使用方式:查阅各参考文件(references/{prefix}-{slug}.md)获取详解与代码示例,完整展开见 AGENTS.md;相关技能包括 react-hook-form 与 orval。

限制:资料未提供具体价格、平台支持或效果数据。