Zod v4 正式发布：性能大幅提升并推出 Zod Mini

TypeScript 优先模式验证库 Zod 已发布第四版稳定版本。新版实现了性能提升、缩减包体积、API 更新，同时也推出全新的简化版树摇（tree-shakable）优化迷你包。

Zod v4 的改进集中在三个关键领域：性能、API 设计和工具链支持。维护方公布的基准测试显示，相比 Zod 3，新版字符串解析速度提升 14 倍，数组解析提速 7 倍，对象解析提速 6.5 倍。这些改进结合 TypeScript 类型实例化优化，有助于大型项目加快编译速度。

本次发布还引入了 @zod/mini 轻量级分发包，压缩后体积仅有约 1.9KB，专为现代前端应用提供树摇验证方案。Zod Mini 的核心优势是实现了树摇能力，这在此前标准版 Zod 中难以实现。为实现该特性，Zod Mini 采用包装函数替代方法类实现，比如在标准版 Zod 中开发者通常使用：

import * as z from "zod";

z.string().optional();

但在 Zod Mini 中，该功能则通过包装函数实现：

import * as z from "zod/mini"; 

z.optional(z.string());

该迷你库体积比标准版 Zod v4 缩小约六倍。

API 优化也是 Zod v4 的重点改进之一。格式辅助函数如 z.email()、z.uuid() 和 z.url() 现已提升为顶级函数，取代原有的方法调用方式并增强树摇效果。错误处理统一改为单错误参数，取代之前分散的处理方式（message、required_error、invalid_type_error）。

开发者现在可以为模式添加强类型元数据，从而实现诸如模式驱动表单生成等新工作流程。

Zod v4 还通过 .toJSONSchema() 方法内置 JSON 格式转换功能，无需再借助外部库实现 Zod 模式到标准化格式的转换。

对于从 v3 升级的团队来说，可使用非官方代码修改工具（zod-v3-to-v4）自动执行常见迁移任务。维护方同时发布了迁移指南，详细说明重大变更及平滑升级建议。

社区反馈中特别强调了性能和元数据两大亮点特性。在 r/reactjs 论坛中，一位开发者表示：

最让我兴奋的是自定义元数据功能，这意味着 Zod 现在可以成为表单生成的可行模式类型。

TypeScript 教程发布者 Matt Pocock 在他的一个视频概览中指出，Zod v4 不仅速度有所提升，他还特别强调了由于 TypeScript 实例化次数减少，性能方面也有优化。同时他详细介绍了 @zod/mini 的推出，并表示具备树摇能力的 Zod 对前端开发极具价值。

早期采用者对该版本表现出高度热情。NextJS Weekly 称 Zod v4 为“怪兽级升级”，开发者们认为速度提升、包体积减小以及扩展性增强是值得迁移的关键理由。

Zod 作为开源项目，在 TypeScript 生态中被广泛用于运行时验证、模式推断和 API 契约管理。开发者可通过文档中的迁移指南进行版本升级。

原文链接：

https://www.infoq.com/news/2025/08/zod-v4-available/