JSON 转 Swift 生成器

如何将 JSON 转换为 Swift – 分步指南

使用此 JSON 转 Swift 生成器，可从 JSON 示例生成 Codable Swift struct，适用于 iOS/macOS 与 Swift 服务。

1. 步骤 1 – 粘贴 JSON 示例

   • 将具有代表性的 JSON 对象或数组粘贴到左侧编辑器中。
   • 尽量包含嵌套对象、数组和可为 null 的字段，方便正确推断类型。
   • 使用 导入 从文件、URL 或示例数据加载 JSON。

2. 步骤 2 – 选择 Swift struct 选项

   • 设置根 结构体名称（例如 Root）。
   • 确认可选字段映射为 String? 等可空类型。
   • 当 JSON 键与 Swift 命名不一致时，确认 key 映射策略。

3. 步骤 3 – 检查生成的代码

   • 确认字段命名、类型推断，以及数组/对象的映射方式是否符合预期。
   • 根据需要调整 根类型名称、空值处理策略以及可选的框架选项。
   • 如果某些字段推断不准确，优化示例 JSON 后重新生成。

4. 步骤 4 – 使用 Codable 解析 JSON

   • 将 struct 加入项目，并确保实现 Codable。
   • 使用 JSONDecoder 将 JSON 解码为根结构体。
   • 按需添加 CodingKeys 或日期解码策略。

5. 步骤 5 – 复制或下载

   • 将输出复制到项目中，或下载为文件。
   • 运行格式化/代码检查工具，让代码风格与项目保持一致。
   • 若目标语言需要序列化/解析库，请在项目中添加相应依赖。

// JSON 输入
{
  "id": 123,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "roles": ["admin", "editor"],
  "metadata": { "plan": "pro" },
  "createdAt": "2024-03-01T10:15:00Z",
  "score": 99.5,
  "notes": null
}

// 生成的 Swift 模型（简化）
struct Metadata: Codable {
  let plan: String
}

struct Root: Codable {
  let id: Int
  let name: String
  let email: String?
  let active: Bool
  let roles: [String]
  let metadata: Metadata
  let createdAt: String
  let score: Double
  let notes: String?
}

相关 JSON 与 Swift 工具

探索更多可与本 JSON 转 Swift 生成器配合使用的 JSON 与 Schema 工具。