Joi 和 Zod 对比：校验库怎么选
Joi 是久经考验的 Hapi 系校验库，Zod 是 TypeScript 时代的类型推导新星。本文从 Schema 定义、类型安全、生态成熟度与性能全面对比。
TypeScript 项目选 Zod（z.infer 从 Schema 推导类型，一份定义双端安全）；纯 JavaScript 项目或深度 Hapi 生态选 Joi（API 成熟、规则丰富）。两者有大量重叠能力，类型推导是分水岭。
出身与定位
Joi：2012 年随 Hapi.js 框架而生，Node.js 校验领域的老兵，API 久经打磨，文档与社区沉淀深厚。
Zod：2020 年出生，TypeScript-first 设计——Schema 即类型是它的核心命题，随 TS 全栈化浪潮成为新项目默认选择。
Schema 定义风格
// Joi：链式方法
const joiSchema = Joi.object({
email: Joi.string().email().required(),
age: Joi.number().int().min(18),
});
// Zod：同样链式，但类型是活推导
const zodSchema = z.object({
email: z.string().email(),
age: z.number().int().min(18).optional(),
});
type User = z.infer<typeof zodSchema>; // 自动得到 TS 类型！
Zod 的 z.infer 消灭了"Schema 与类型定义两份维护"——这是它对 TS 项目的杀手锏。
复杂校验能力
两者都覆盖：条件校验（Joi 的 when / Zod 的 superRefine）、自定义规则（custom / refine）、递归 Schema（嵌套评论树等）。Joi 的内置规则库更厚（信用卡、IP、URI 等开箱即用）；Zod 靠 refine 自定义补足，生态有 zod-plugin 类扩展。
类型安全与集成
- Zod：类型从 Schema 推导，改 Schema 即改类型，前后端共享 Schema（tRPC、React Hook Form 深度集成）——全栈 TS 的基石级工具；
- Joi：类型与 Schema 分离维护，TS 项目里存在双写漂移风险。
生态与成熟度
Joi 胜在稳定与文档厚度；Zod 胜在增长势头与 TS 生态整合度（tRPC、Drizzle、React Hook Form、shadcn/ui 全链条）。性能两者都够用，极端场景 Zod 略优。
决策一句话
新项目 + TypeScript → Zod；维护中的 JS 项目 → Joi 继续；Hapi 存量 → Joi 原生。
常见问题（FAQ）
Q：Zod 能在纯 JavaScript 项目用吗？
能（运行时校验与 TS 无关），但失去类型推导后优势减半——JS 项目选 Joi 也合理。
Q：浏览器端校验哪个更合适？
Zod（体积更小、tree-shaking 友好），且前后端共享同一份 Schema 是全栈 TS 的标准玩法。
Q：从 Joi 迁移到 Zod 难吗？
Schema 定义风格相似，主要工作量在替换校验调用点（validate → safeParse）与错误结构适配。渐进迁移可行：新模块用 Zod，旧模块随重构替换。
参考文档
本文依据公开文档整理，示例需按项目依赖版本验证；不将文档中的性能描述视为本项目实测结果。
