Swift Academy · 课时

Codable：编码与解码 JSON

Q: 「Codable：编码与解码 JSON」这节课中我会学到什么？

遵循 Codable，使用自定义 CodingKeys，并解码嵌套容器。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

遵循 Codable，使用自定义 CodingKeys，并解码嵌套容器。

Codable：编码与解码 JSON 是 CoddyKit 上的免费 Swift Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。

Codable 协议

Codable 是 Encodable & Decodable 的类型别名。符合该协议的类型可以自动编码为 JSON，也可以从 JSON 解码。

struct User: Codable {
  var name: String
  var age: Int
}

自动合成

当所有存储属性本身都符合 Codable 时，Swift 会自动合成 Codable 的实现。

struct Product: Codable {
  var id: Int
  var title: String
  var price: Double
  // init(from:) and encode(to:) are auto-generated
}

解码 JSON

使用 JSONDecoder 将 Data 解码为您的 Decodable 类型。

let json = #"{"name":"Alice","age":30}"#.data(using: .utf8)!
let user = try JSONDecoder().decode(User.self, from: json)
print(user.name) // Alice

编码为 JSON

使用 JSONEncoder 将 Codable 值编码为 Data。

let user = User(name: "Bob", age: 25)
let data = try JSONEncoder().encode(user)
print(String(data: data, encoding: .utf8)!)

自定义 CodingKeys

使用 CodingKeys 枚举在 Swift 属性名称与 JSON 键之间建立映射。

struct Article: Codable {
  var createdAt: Date
  enum CodingKeys: String, CodingKey {
    case createdAt = "created_at"
  }
}

日期解码策略

配置 JSONDecoder.dateDecodingStrategy，以解析各种格式的日期。

let decoder = JSONDecoder()
decoder.dateDecodingStrategy = .iso8601
let article = try decoder.decode(Article.self, from: data)

嵌套容器

通过定义嵌套的 Codable 结构体，或手动使用键控容器，来解码嵌套的 JSON 对象。

struct Response: Codable {
  struct Data: Codable {
    var users: [User]
  }
  var data: Data
}
let resp = try JSONDecoder().decode(Response.self, from: json)

自定义解码逻辑

为非标准 JSON 结构重写 init(from:)，或在解码过程中应用转换。

struct Rating: Codable {
  var stars: Int
  init(from decoder: Decoder) throws {
    let container = try decoder.singleValueContainer()
    let raw = try container.decode(Double.self)
    stars = Int(raw.rounded())
  }
  func encode(to encoder: Encoder) throws {
    var container = encoder.singleValueContainer()
    try container.encode(Double(stars))
  }
}

keyDecodingStrategy

使用 .convertFromSnakeCase，自动将 JSON 的 snake_case 键转换为 Swift 的 camelCase 属性。

let decoder = JSONDecoder()
decoder.keyDecodingStrategy = .convertFromSnakeCase
let user = try decoder.decode(User.self, from: data)
// "first_name" → firstName

编码选项

配置 JSONEncoder.outputFormatting，以生成格式化或排序后的输出。

let encoder = JSONEncoder()
encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
let data = try encoder.encode(product)

处理可选字段

将属性标记为可选项，以便优雅地处理缺失的 JSON 键，而不会抛出错误。

struct User: Codable {
  var name: String
  var bio: String?  // nil if "bio" key is absent from JSON
}

快速检查

哪个 JSONDecoder 策略会自动将 JSON 的 snake_case 键映射为 Swift 的 camelCase 属性名称？

课程回顾

遵循 Codable 协议即可自动进行 JSON 编码和解码。使用 CodingKeys 重新映射属性名称；对于使用 snake_case 的 API，使用 keyDecodingStrategy = .convertFromSnakeCase；对于非标准 JSON，使用自定义的 init(from:)；解析日期时使用 dateDecodingStrategy。

常见问题解答

「Codable：编码与解码 JSON」课时是免费的吗？

是的 — 「Codable：编码与解码 JSON」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。

「Codable：编码与解码 JSON」这节课中我会学到什么？

遵循 Codable，使用自定义 CodingKeys，并解码嵌套容器。你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「Codable：编码与解码 JSON」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

使用 async/await 调用 URLSession data(from:)
Codable：编码与解码 JSON
错误处理与 HTTP 状态码
重试逻辑与后台 URLSession

← 返回 Swift Academy