JSON 转 Swift
从 JSON 生成 Swift Codable 结构体或类
粘贴 JSON 或加载示例以生成 Swift 代码。
JSON 转 Swift 会生成什么
JSON 转 Swift 会将 API 响应或任意 JSON 示例转换为 Swift 类型。结构体自动获得逐一成员初始化器;final class 会获得生成的 init。当属性名与其键不同时(例如 user_name → userName),会用 CodingKeys 枚举把每个属性映射回 JSON。class 等保留字会用反引号转义,并保留原始名称。
使用方法
- 1.粘贴 JSON、上传或拖放 .json 文件,或加载一个示例。
- 2.设置根类型名称并选择类型风格。
- 3.选择协议遵循和 CodingKeys 策略(名称不同时、始终或从不)。
- 4.阅读输出下方的提示,然后复制代码或下载 Models.swift。
类型如何推断
- •会检查数组中的每个元素,而不只是第一个,同一数组中的对象会被合并。
- •部分对象中缺少的键为可选;有时为 null 的键为可为 null。两者分开处理。
- •同一位置出现 1 和 2.5 时会放宽为小数;其他混合情况会给出提示。
- •空数组和始终为 null 的值没有类型依据,因此使用通用类型,并附提示说明原因。
- •类型映射:string → String,整数 → Int(超出范围时为 UInt64 或 Decimal),小数 → Double,布尔值 → Bool,数组 → [T],对象 → 嵌套类型,缺失或 null → T?,未知或混合 → JSONValue(无协议遵循时为 Any)。
限制与隐私
示例只反映数据某一次的样子,而不是完整的 API 契约。在依赖这些代码之前,请检查可选字段、通用类型和数字宽度。输入限制为 5 MB 和 256 层嵌套;从 2 MB 起,需点击“生成”按钮才会生成。所有处理都在您的浏览器中运行,JSON 不会被上传。如果选择从不生成 CodingKeys,重命名的属性将不再与其 JSON 键匹配;提示中会逐一列出。
