JSON转Elixir结构

从 JSON 样本推断 Elixir 结构

把合法 JSON 粘贴到输入区后，工具会根据样本中的对象、数组、字符串、数字、布尔值和 null 推断字段类型，并生成 Elixir 代码。JSON 是数据交换文本格式；其中对象的键名始终是字符串。生成结果是代码草稿，不是已经解码到运行时的 Elixir 数据，也不等于完整 API schema。

输入可以是单个对象，也可以是数组或带嵌套对象的响应样本。根节点类型会影响输出模型的入口结构；数组中的记录若有不同字段，生成结果是否把字段标为可选也取决于样本是否展示了这些差异。为避免只覆盖理想响应，最好用真实、具有代表性的输入。

Map 与 struct 解决的问题不同

Map 与 struct 解决的问题不同

Elixir map 适合键集合需要灵活变化的键值数据；struct 是带模块名称和预先定义字段的 map，字段集合更明确。这个页面面向 Elixir 输出，通常会生成 struct 模块以及与 JSON map 转换有关的代码；“仅类型定义”选项会改变输出范围。把外部 JSON 接入项目时，还要核对生成字段、输入 JSON 键名、必填与可空规则，以及项目实际采用的解码方式。

准备样本、生成并检查代码

1. 粘贴有效 JSON

   输入完整 JSON 文本，键名使用双引号，字符串也使用双引号。可以先用格式化操作整理缩进；语法错误时，工具不会生成有效输出。

2. 设置根类型名称

   在类型名称栏填写 Elixir 模块所需的名称。含多层对象时，建议先用能表达主要对象含义的名称，再检查子类型名称是否清楚。

3. 选择输出选项

   按用途决定是否只输出类型定义。生成结果出现后，先检查字段和类型，再复制代码或下载文件。

生成器只使用当前输入框里的 JSON 样本。它不会自动读取接口地址、项目 schema 或多次运行的历史输入，所以遗漏字段不会因为你曾在其他页面输入过而被补进来。

如果样本的根节点是列表，保留列表结构有助于呈现元素类型；如果只输入一个对象，生成结果更聚焦于该对象字段。根类型名称应符合模块命名习惯，输出里的每个模块和辅助函数仍要按项目实际目录与接口契约调整。

生成结果常见疑问

它会把 JSON 字符串直接变成 Elixir struct 值吗？

不会。页面输出的是 Elixir 源代码；你仍需在项目中编译并调用适合的 JSON 解码流程，才能把实际数据转换成运行时值。

一个样本能说明哪些字段是可选的吗？

单个样本只能展示它实际出现的字段和值类型，不能可靠覆盖接口在其他响应中省略字段、返回 null 或出现不同类型的情况。可用包含多种实际记录的 JSON 数组补充样本信息，再人工核对结果。

字段名一定会和服务端 JSON 键名完全一样吗？

不应直接假定完全一致。检查生成的字段标识和转换代码如何对应原始键名，尤其留意大小写、连字符、保留字和特殊字符。

生成代码仍需纳入项目校验

样本推断无法替代正式 schema、接口契约或应用测试。请检查结构名称、嵌套类型、空值处理、必填规则以及 JSON 字符串键与 Elixir 字段的映射，再在目标 Elixir 版本和项目编译环境中验证。敏感数据不要粘贴到不适合处理该数据的环境中。此外，JSON 中的 null 与“某个对象没有这个键”不是同一种输入状态。对于可空字段、可缺省字段、枚举变体或数字边界，应准备能代表这些情况的样本，并在集成前按接口约定复查。