JSON 转 Swift

将 JSON 数据转换为 Swift Codable Struct,基于 quicktype 引擎,支持 struct 与 class 风格切换。

使用说明

功能介绍

本工具基于 quicktype 引擎将 JSON 数据自动转换为 Swift Codable Struct/Class,支持类型推断(String/Bool/Int/Double/Array/嵌套类型),并提供多项渲染选项:类型风格(struct/class)、访问级别(internal/public)、仅类型模式、可变属性。生成的代码可直接配合 JSONEncoder/JSONDecoder 进行序列化。

选项说明

  • 根类型名称:生成的顶层类型名称,默认 Root。
  • 类型风格:struct(值类型,默认)或 class(引用类型)。
  • 访问级别:internal(模块内可见,默认)或 public(跨模块可见)。
  • 仅类型:仅生成类型定义,不生成辅助编解码代码,适合配合自定义序列化使用。
  • 可变属性 (var):使用 var 声明属性替代 let,允许实例化后修改属性值。

操作步骤

在左侧文本框输入或粘贴 JSON 数据,设置根类型名称与各项渲染选项,右侧将实时生成 Swift 代码,点击「复制结果」一键复制到剪贴板。也可点击「加载示例」快速体验。

注意事项

数字类型根据值自动推断为 Int(整数)或 Double(浮点数);null 值会推断为可选类型(Optional);数组推断为 [T]。嵌套对象会生成对应的嵌套类型定义。开启「仅类型」后不生成 CodingKeys 与辅助编解码方法,需自行实现 Codable 协议。使用 class 风格时如需继承 NSObject,请手动调整生成代码。