# JSON 转 Zod

根据 JSON 示例生成 Zod schema。嵌套对象会成为单独导出的 schema，部分数组项中缺失的键会变为 .optional()，null 值会变为 .nullable()，混合值会变为 z.union。每个 schema 还会生成一个 z.infer 类型别名，只需粘贴一次即可同时获得运行时验证和 TypeScript 类型。

## 常见问题

### 嵌套对象如何命名？

每个嵌套对象都会成为独立的 Zod 类型，并以包含它的键名转换为 PascalCase 后命名，例如 address 会变为 Address。数组中的对象会使用数组键名的单数形式，例如 users 会变为 User。字段完全相同的对象会共用同一个类型。

### 字段在什么情况下会是可选的？

当数组中包含多个对象，且某个键在部分对象中缺失时，该字段就是可选的：schema 会添加 .optional()。每个示例中都存在的键为必填项。单个对象没有可供比较的对象，因此其中所有键都是必填项。

### 如何处理 null 值？

如果某个键在部分示例中为 null，在其他示例中有值，它会变为原类型后接 .nullable()。如果某个键始终为 null，工具就无法得知它的实际类型，因此会将其变为 z.null()；粘贴包含实际值的示例即可生成精确类型。

### 会使用哪些数字类型？

整数会变为 z.number().int()，带小数的数字会变为 z.number()。同一字段同时包含两者时，schema 会使用 z.number()，因为所有整数也都是有效的数字。

### 如何处理无效名称的键？

键名如果不是有效的 JavaScript 标识符，例如 first-name，就会在 z.object 中加上引号，因此 schema 仍会与原始 JSON 键名完全匹配。

### 我的 JSON 会被上传或存储吗？

JSON 仅会发送到服务器以便为此次请求生成代码，不会被存储。生成器只会读取示例的结构和值类型，因此你可以在粘贴前将敏感值替换为类型相同的占位值。

在这里投放广告？

[给我们发邮件](mailto:hi@dennn.is?subject=%E5%9C%A8%20OneClick%20Pro%20%E4%B8%8A%E6%8A%95%E6%94%BE%E5%B9%BF%E5%91%8A)

[广告 通过一个 MCP 服务器为你的 AI 代理提供 433 种工具。](https://multitaskai.com/zh/?ref=oneclickpro)
