Swift中为映射JSON的结构体设别名，兼容group字段并避命名冲突

核心方案：重命名结构体 + 利用CodingKeys指定JSON映射 #

通过以下操作即可解决命名冲突，同时完全保留与API返回JSON的映射能力：

• 重命名自定义结构体
  把原Group结构体改为其他名称（比如APIGroup），彻底规避与SwiftUI内置Group的命名冲突：

  struct APIGroup: Codable {
      var id: Int64
      var ownerId: Int64
      var memberId: Int64
      var name: String
      var created: String
      var active: Int
      
      // 定义CodingKeys枚举，明确Swift属性与JSON字段的对应关系
      enum CodingKeys: String, CodingKey {
          case id = "ID"
          case ownerId = "OwnerId"
          case memberId = "MemberId"
          case name = "Name"
          case created = "Created"
          case active = "Active"
      }
  }
  

• 处理顶层JSON的group字段
  如果API返回的完整JSON是包含group键的对象（如下所示），需要定义一个顶层响应结构体，通过CodingKeys将JSON的group字段映射到我们的自定义结构体属性：

  {
      "group": {
          "ID":4,
          "OwnerId":22,
          "MemberId":17,
          "Name":"FirstGroup",
          "Created":"2024-02-23",
          "Active":1
      }
  }
  

  对应的顶层结构体代码：

  struct GroupResponse: Codable {
      let apiGroup: APIGroup
      
      enum CodingKeys: String, CodingKey {
          case apiGroup = "group"
      }
  }
  

• 解析示例
  使用JSONDecoder解析API响应时，直接使用顶层结构体即可：

  let jsonData = // 从API获取的二进制JSON数据
  do {
      let response = try JSONDecoder().decode(GroupResponse.self, from: jsonData)
      let targetGroup = response.apiGroup
      // 后续使用targetGroup的属性即可
  } catch {
      print("JSON解析失败：\(error)")
  }
  

关键说明 #

• CodingKeys是Codable协议的核心机制，它完全掌控Swift类型与JSON字段的映射逻辑——不管你的结构体或属性叫什么名字，只要在CodingKeys中指定对应的JSON键名，就能完成正确映射。
• 重命名结构体后，只要通过CodingKeys将JSON中的group字段与自定义结构体的属性关联，就不会影响任何解析逻辑。

内容的提问来源于stack exchange，提问作者raddevus