TypeBox 和 Joi 对比：两代校验库的对话
Joi 久经考验，TypeBox 类型原生且输出标准 JSON Schema。本文从 Schema 定义、类型集成、生态与性能全面对比。
TypeScript 项目选 TypeBox（类型推导 + JSON Schema 标准 + 性能领先）；纯 JS 项目或 Hapi 存量选 Joi。决策轴与 Joi vs Zod 相同——类型时代的校验库已换代，TypeBox 的差异化在标准 Schema 输出。
Schema 风格
// Joi
Joi.object({ email: Joi.string().email().required() });
// TypeBox
Type.Object({ email: Type.String({ format: 'email' }) });
链式 API 神似——但 TypeBox 的产物是标准 JSON Schema，Joi 的产物是私有结构。
类型集成
- Joi：类型与 Schema 双份维护；
- TypeBox：Static
一键推导——TS 项目的核心价值。
JSON Schema 的杠杆
TypeBox Schema 可直接喂给：Fastify 路由校验、OpenAPI 文档生成、Ajv 校验器——一份定义贯穿接口契约全链路。Joi 的私有格式没有这层生态。
性能
TypeBox（尤其编译模式）在基准中显著快于 Joi——高频校验路径差异可感知。
决策
新 TS 项目：TypeBox 或 Zod；Hapi 存量：Joi；JS 项目：Joi 的 API 手感仍好。
常见问题（FAQ）
Q：Joi 项目迁移 TypeBox 的成本？
Schema 定义重写（API 映射直接），调用点适配（validate → Value.Check）。中等成本，类型收益大。
Q：TypeBox 的错误消息友好吗？
默认是结构化技术消息——业务化需映射层。Joi 的消息定制开箱更友好。
Q：TypeBox 支持转换（trim、类型转换）吗？
Value.Convert/Transform 支持——但"校验与转换分离"的纯净派用法更推荐（转换显式做）。
参考文档
本文依据公开文档整理，示例需按项目依赖版本验证；不将文档中的性能描述视为本项目实测结果。
