TypeBox 和 Zod 对比：TS 校验双雄怎么选
Zod 是 Schema 即类型的生态霸主，TypeBox 输出标准 JSON Schema 且性能更强。本文从 Schema 定义、类型推导、生态与性能全面对比。
全栈应用开发默认选 Zod（生态集成最深：tRPC/RHF/Drizzle）；需要 JSON Schema 标准输出（OpenAPI、Fastify）或极致校验性能选 TypeBox。两者类型推导能力相当，生态与标准是分界线。
哲学差异
Zod：TS 优先的自由格式——API 为开发者体验打磨，生态做厚。
TypeBox：标准为锚——Schema 即 JSON Schema，类型是标准格式的投影。
Schema 定义
// Zod
const User = z.object({
email: z.string().email(),
age: z.number().int().min(0).optional(),
});
type User = z.infer<typeof User>;
// TypeBox
const User = Type.Object({
email: Type.String({ format: 'email' }),
age: Type.Optional(Type.Integer({ minimum: 0 })),
});
type User = Static<typeof User>;
推导能力等价——API 风格看个人偏好。
生态对比
- Zod：tRPC、React Hook Form、Drizzle ORM、zod-to-openapi——全栈 TS 的毛细血管；
- TypeBox：Fastify 官方集成、JSON Schema 工具链（Ajv、OpenAPI 生成器）直通。
性能
TypeBox 编译模式（TypeCompiler）是校验性能的天花板；Zod 常规够用，极端吞吐场景有差距。API 请求体校验两者都无感——性能只在数据管道类场景成为决策因素。
决策速查
| 场景 | 选择 |
|---|---|
| Next.js/tRPC 全栈 | Zod |
| Fastify 后端 | TypeBox |
| OpenAPI 文档驱动 | TypeBox |
| 数据管道高频校验 | TypeBox（编译模式） |
| 拿不准 | Zod（生态兜底） |
常见问题（FAQ）
Q：能混用吗？
能但没必要——一个项目统一一个校验库。转换工具存在但不完美。
Q：Valibot 的位置？
Valibot 是 Zod 的模块化轻量版（体积敏感场景）。三个都同代际，按体积/生态/标准三个轴各选所爱。
Q：错误处理体验？
Zod 的 error.flatten/issues 生态封装更成熟；TypeBox 的 Value.Errors 结构化但需自建业务映射。
参考文档
本文依据公开文档整理，示例需按项目依赖版本验证；不将文档中的性能描述视为本项目实测结果。
