JSON转Ruby类

从 JSON 样例推断 Ruby 类型结构

把一段有效 JSON 粘贴到输入区后，页面会据此生成 Ruby 代码。对象中的字段、嵌套对象和数组会成为模型结构的线索；可修改根类型名称，并在 Ruby 选项中调整严格性或选择只输出类型定义。转换依据是你给出的样例，因此更适合快速搭建数据模型草稿，而不是替代完整的数据契约。

例如，样例 {"user":{"name":"李明","age":28},"tags":["ruby","json"]} 同时包含嵌套对象和字符串数组。生成结果会围绕这些字段组织 Ruby 类型；如果真实接口还会返回样例里没有的字段或其他类型，需要补充样本并检查生成结果。

Ruby 解析值与类定义要分开理解

Ruby 自带的 JSON 模块解析 JSON 时，默认把对象读成 Hash、数组读成 Array；字符串、数字、布尔值和 null 则分别对应 Ruby 的基础值。下面是解析后的常见对应关系：

因此，“把 JSON 解析成 Ruby 数据”与“根据 JSON 结构生成 Ruby 类定义”是两件相邻但不同的事。类定义为字段组织提供骨架；运行时解析仍取决于你的程序如何读取 JSON。Ruby 官方文档列出了 JSON.parse 的默认行为，JSON 允许的值类型可参阅 IETF RFC 8259。

准备样例并检查生成代码

1. 输入完整 JSON

   粘贴一个语法正确的 JSON 值。键名和字符串使用双引号，逗号、括号成对；可以先载入示例，再替换成自己的接口响应或配置数据。

2. 设置根类型名称

   按项目中的命名习惯填写类型名称。输入变化后会重新生成；Ruby 选项可以调整类型检查严格性，也可以切换是否只生成类型定义。

3. 确认并取用结果

   检查字段类型、嵌套层级和空值处理。确认后复制代码，或下载为 Ruby 文件，再放入项目并按实际数据补充逻辑。

如果响应结构有多个版本，可以用另一份代表性样本再生成一次并比较字段差异；不要把单一响应当作所有版本的完整结构。

输入与类型推断的常见问题

生成代码需要结合项目验证

生成结果描述的是样例中可见的数据形状，不会替你验证 API 契约、业务必填规则或项目中的序列化约定。将代码接入应用前，请检查空值、可选字段、数值范围和命名，再用真实样本运行项目自己的解析与测试流程。

复制前也要检查命名和项目约定。字段缩写、保留字或团队采用的命名风格可能需要手动调整；样例里出现一次的空值，不足以单独判断字段在业务上是否必填或允许为空。