Valibot 与 Zod 的高级校验功能对比：从 superRefine 到 rawCheck

在数据验证库的选型过程中，开发者常常需要在 Zod 和 Valibot 之间做出选择。本文将深入探讨这两个库在高级校验功能方面的异同，特别是针对 Zod 中 superRefine 方法的替代方案。

Zod 的 superRefine 方法

Zod 提供的 superRefine 方法是一个强大的工具，允许开发者在单个校验过程中执行多个复杂的验证逻辑。典型的应用场景包括：

1. 检查输入是否为空
2. 验证输入长度是否超过限制
3. 执行多个相关条件的复合验证

这种方法的优势在于可以在一个函数内处理多个验证条件，并根据不同情况返回不同的错误信息。

Valibot 的解决方案

Valibot 目前正在经历重大重构，其开发团队已经宣布将在未来版本中引入 rawCheck 和 rawTransform 两个新 API，这些功能将提供与 Zod 的 superRefine 类似的能力。

当前版本的限制

在 Valibot 的当前版本中，开发者需要使用 custom 验证器配合管道(pipeline)来实现类似功能。然而，这种方法在处理多个相关条件时存在局限性，特别是当需要基于前一个验证结果执行后续验证时。

未来版本的改进

即将发布的 Valibot 新版本将解决这些限制，通过 rawCheck 和 rawTransform 提供更灵活的验证方式：

1. rawCheck：专注于验证逻辑，可以添加多个自定义验证条件
2. rawTransform：在验证的同时允许对数据进行转换

这些新 API 将使 Valibot 在复杂验证场景下的能力与 Zod 相当，同时保持其轻量级和模块化的设计理念。

迁移建议

对于计划从 Zod 迁移到 Valibot 的开发者，建议：

1. 等待 Valibot 新版本发布（预计3-4周内）
2. 评估 rawCheck 是否能完全替代现有 superRefine 逻辑
3. 考虑新 API 带来的额外功能，如数据转换能力
4. 测试性能差异，特别是在复杂验证场景下

结论

Valibot 正在积极改进其高级验证功能，即将推出的 rawCheck 和 rawTransform API 将有效填补与 Zod 在复杂验证能力上的差距。对于需要高级验证功能的项目，等待新版本发布后再进行迁移可能是更稳妥的选择。