用途:Zog 用于 Go 语言的数据 schema 校验,API 形似 Zod 但贴合 Go 语义,适用于在 IO 边界解析输入,或对已有类型的值做校验。
主要能力:支持 z.Shape、z.Struct、z.Ptr、z.Slice、z.Pick/Omit/Extend/Merge 等 schema 构造;Parse 会强制转换输入,Validate 不转换且成功路径不分配内存;提供 Test、TestFunc、Not、Transform、Preprocess、自定义 schema(Like、CustomFunc、Boxed)以及 zhttp、zjson、zenv 等输入适配器;返回 z.ZogIssueList([]*z.ZogIssue),可用 len(errs) > 0 判断。
用法要点:Parse(data, &dest, opts...) 用于 IO 边界,Validate(&value, opts...) 用于已类型化的值,目标都必须是指针。schema 建议在包级声明一次以便复用。.Required() 先于所有测试和变换执行;.Default 优先级高于 .Required;.Catch 会吞掉所有 issue 并终止链。Test 的链式位置即执行顺序。消息用 z.Message 或 z.MessageFunc 设置在产生它的测试上。
限制:Zog 在 schema 定义错误时 panic,不对输入数据 panic;z.Shape 的 key 对应 Go 结构体字段而非输入 key;z.Struct(...).Required() 与 .Optional() 无效;结构体不支持 .Default 和 .Catch,切片支持 .Default 但不支持 .Catch;Parse 只把 nil 输入视为缺失,Validate 把 Go 零值视为缺失,缺失值会跳过所有测试。zhttp 与 zjson 只能解析进结构体。Zog 处于 pre-1.0,API 会随次版本变动,使用前应查看 go.mod 中的版本。其他细节暂未提供。