.ts · text/typescript

Zod 結構描述: Zod 執行期驗證 Schema

Zod Schema 將執行期 JSON 解析驗證(`z.object`、`z.array`、`.optional()`)與透過 `z.infer<typeof schema>` 自動衍生的靜態 TypeScript 型別完美結合。

快速解答: Zod Schema 將執行期 JSON 解析驗證(`z.object`、`z.array`、`.optional()`)與透過 `z.infer<typeof schema>` 自動衍生的靜態 TypeScript 型別完美結合。 執行期 API 邊界驗證、tRPC/React Hook Form 表單驗證與單一來源 TypeScript 型別推導。

結構類型具型別程式碼
人類可讀性高
支援巢狀結構支援
LLM Token 效率中
副檔名.ts
MIME 類型text/typescript
最適合用於執行期 API 邊界驗證、tRPC/React Hook Form 表單驗證與單一來源 TypeScript 型別推導。

核心優勢

  • 在執行期驗證不可信 JSON 的同時自動推導靜態 TypeScript 型別
  • 及早捕捉遺漏鍵名、錯誤基本型別與 API 漂移並輸出清晰錯誤
  • 支援嚴格物件檢查 (.strict()) 以拒絕未預期多餘鍵名

限制與權衡

  • 相較編譯後抹除的 TypeScript 介面,會帶來少量執行期程式庫體積
  • 深層遞迴結構仍須搭配明確的手動型別提示
  • 若外部 API 常新增無害欄位,嚴格物件模式可能導致向前相容中斷

參考資料

在本機轉換與清理 Zod 結構描述

相關工程指南

Zod 結構描述 常見問題

為什麼要產生 Zod Schema 而不只使用純 TypeScript 介面?

TypeScript 型別在執行期會消失。Zod 會在執行期驗證實際傳入的 JSON 回應並自動匯出 z.infer<typeof schema>。

JSON 轉 Zod 中的「嚴格物件模式」有什麼效果?

它會在產生的 z.object(...) 加上 .strict(),使未定義的多餘屬性直接拋出驗證錯誤而非靜默濾除。

巢狀 JSON 物件與混合陣列能自動處理嗎?

可以。巢狀結構會自動產生巢狀 z.object()、z.array()、z.union() 及 .nullable() / .optional() 修飾子。