Valibot 深度解析：如何优雅实现 Schema 只读化

在 TypeScript 生态中，数据不可变性（Immutability）是一个重要的设计原则。Valibot 作为一个现代化的 Schema 验证库，提供了对数据只读特性的原生支持。本文将深入探讨 Valibot 中实现 Schema 只读化的几种技术方案，并分析其适用场景。

基础只读实现

Valibot 提供了最基础的 readonly 动作（action），可以通过管道（pipe）方式应用到任何 Schema 上：

import * as v from 'valibot';

const BasicSchema = v.pipe(
  v.object({
    name: v.string(),
    age: v.number()
  }),
  v.readonly()
);

这种方式的优点是简单直接，缺点是当 Schema 结构复杂时，需要手动为每个嵌套属性添加 readonly，这在大型项目中会显得冗长。

类型层面的只读保障

对于需要确保整个 Schema 树都是只读的场景，我们可以结合 TypeScript 的类型系统来实现：

type DeepReadonly<T> = Readonly<{
    [K in keyof T]: T[K] extends (number | string | symbol) ? Readonly<T[K]>
        : T[K] extends Array<infer A> ? Readonly<Array<DeepReadonly<A>>>
            : DeepReadonly<T[K]>;
}>;

然后在使用 parse 方法时进行类型断言：

const output = v.parse(Schema, inputData) as DeepReadonly<
  v.InferOutput<typeof Schema>
>;

这种方法虽然需要类型断言，但能确保整个对象树的只读性，适合在 Flux 架构或状态管理场景中使用。

最佳实践建议

1. 简单场景：直接使用 pipe 和 readonly 的组合
2. 复杂对象树：结合 DeepReadonly 类型和类型断言
3. 库开发：考虑实现运行时检查，确保传入的 Schema 都是只读的

Valibot 的这种设计既保持了灵活性，又为不可变数据提供了良好支持。开发者可以根据具体场景选择最适合的方案，在类型安全和开发体验之间取得平衡。