性能

基准测试基础设施

Zod 包含一个全面的基准测试套件，用于衡量各种模式类型和验证场景的性能。该基准测试基础设施使用 benchmark 库来提供一致且可靠的性能测量。

来源：src/benchmarks/index.ts1-59 deno/lib/benchmarks/index.ts1-59

基准测试可以通过基准测试入口点运行，该入口点允许运行所有基准测试套件或通过命令行参数选择特定的套件。每个基准测试套件都专注于 Zod 功能的特定方面，从而实现有针对性的性能分析。

运行基准测试

要在 Zod 代码库中运行基准测试，请使用以下方法

# Run all benchmarks
yarn benchmark

# Run specific benchmark suites
yarn benchmark -- --primitives --object --realworld

基准测试系统旨在测试有效和无效输入，从而深入了解不同条件下的性能特征。

来源：src/benchmarks/index.ts12-49 deno/lib/benchmarks/index.ts12-49

模式类型性能特征

Zod 中不同的模式类型具有不同的性能特征。理解这些差异有助于为性能关键型应用程序优化模式设计。

来源：src/benchmarks/primitives.ts1-173 deno/lib/benchmarks/primitives.ts1-173 src/benchmarks/realworld.ts1-63 deno/lib/benchmarks/realworld.ts1-63

基本类型

Zod 中原始类型的验证通常是最快的。基准测试套件包含针对各种原始类型的测试，揭示了它们的相对性能特征

Schema 类型	有效输入	无效输入	备注
`z.literal()`	非常快	快	简单相等性检查
`z.number().int()`	快	快	类型检查 + 整数检查
`z.enum()`	快	快	性能取决于枚举大小
`z.date()`	中等	快	日期操作成本更高
`z.symbol()`	快	快	简单类型检查

枚举的大小对性能有显著影响。包含许多选项的长枚举比包含少量选项的短枚举性能更慢。

来源：src/benchmarks/primitives.ts8-161 deno/lib/benchmarks/primitives.ts8-161

复杂类型

对象、数组和联合等复杂类型涉及更多的验证步骤，因此通常比原始类型慢。

Schema 类型	性能特征
`z.object()`	性能随属性数量及其复杂性而变化
`z.array()`	性能随数组长度和项目模式复杂性而变化
`z.union()`	性能取决于选项数量及其顺序
`z.discriminatedUnion()`	由于优化的类型选择，比普通联合更快

实际场景的基准测试评估了代表典型应用程序数据结构的复杂嵌套模式的性能。

来源：src/benchmarks/realworld.ts5-56 deno/lib/benchmarks/realworld.ts5-56

验证过程性能

了解验证过程中每个步骤的性能影响有助于识别潜在的瓶颈。

来源：src/benchmarks/primitives.ts11-19 deno/lib/benchmarks/primitives.ts11-19

错误处理的影响

Zod 中的错误处理对性能有显著影响。由于创建错误对象、格式化错误消息以及可能处理错误上下文的额外开销，验证失败比成功验证的成本更高。

场景	相对性能
有效数据	更快
无效数据	更慢（错误创建开销）
复杂错误格式化	最慢（额外处理）

为了最大限度地减少生产环境中错误对性能的影响，请考虑使用 safeParse() 而不是 parse()，并实现自定义错误处理策略。

来源：src/benchmarks/primitives.ts49-53 deno/lib/benchmarks/primitives.ts49-53

字符串验证性能

字符串验证是许多应用程序中的常见操作。Zod 包含几种具有不同性能特征的字符串验证方法。

正则表达式性能

正则表达式性能对于字符串验证尤为重要。IPv4 基准测试套件测试了各种用于 IP 地址验证的正则表达式模式，突出了显著的性能差异。

正则表达式模式	相对性能	备注
简单模式	更快	捕获组更少，回溯更少
复杂模式	更慢	捕获组更多，回溯更多
优化模式	可变	特定优化可以提高性能

基准测试中 IPv4 验证性能最佳的正则表达式模式是模式 E。

/^((25[0-5]|(2[0-4]|1\d|[1-9]|)\d)\.){3}(25[0-5]|(2[0-4]|1\d|[1-9]|)\d)$/

来源：src/benchmarks/ipv4.ts5-49 deno/lib/benchmarks/ipv4.ts5-49

优化策略

根据基准测试结果和性能特性，以下是优化 Zod 模式性能的策略

1. 模式设计优化

来源：src/benchmarks/realworld.ts7-21 deno/lib/benchmarks/realworld.ts7-21

模式结构指南

简化模式：尽可能减少嵌套深度
使用判别联合（discriminated unions）：它们比普通联合更快
排序联合类型：将更常见的类型放在联合中的首位
减少属性数量：只验证必要的内容
考虑模式重用：对相似结构重用模式定义

2. 验证策略优化

使用 safeParse()：在预期验证失败时，避免异常开销
批量验证：一次性验证多个项目，而不是逐个验证
预验证关键条件：在应用完整模式之前检查关键条件

3. 错误处理优化

自定义错误映射：错误消息中只包含必要的信息
惰性错误生成：使用自定义错误处理器，仅在需要时才生成详细错误

跨平台性能考量

Zod 支持 Node.js 和 Deno 环境。这些平台之间的性能特性可能有所不同。

Node.js：通常针对同步操作进行优化
Deno：对于某些操作可能具有不同的性能特性

基准测试套件适用于这两个平台，允许在您的特定环境中进行性能测试。