SuperAPI AI 工具集

swift-codable

编程与开发

查看项目

更新于 10-16 07:20

技能介绍

用途:指导在 Swift 6.3 / iOS 26+ 中用 Codable(Encodable 与 Decodable)配合 JSONEncoder、JSONDecoder 及相关 API 进行数据类型与 JSON 之间的编码和解码。

主要能力:可合成基础遵循;通过 CodingKeys 重命名键;自定义 init(from:) 与 encode(to:) 处理转换;用 nestedContainer、nestedUnkeyedContainer 处理嵌套与扁平化结构;配置 dateDecodingStrategy(如 .iso8601、.secondsSince1970、.formatted、.custom)、dataDecodingStrategy(如 .base64)与 keyDecodingStrategy(如 .convertFromSnakeCase);处理异构数组、单值容器、缺失键默认值、有损数组解码;与 URLSession、SwiftData、UserDefaults 的集成要点。

使用方式:先解码代表性成功、缺失、null、畸形、缩写键和日期样本;失败时检查 DecodingError、codingPath 与原始负载;只修正不匹配的模型、键、容器或策略,不要用有损解码掩盖契约失败;再重跑样本与编解码往返验证。命令行与安装命令资料未提供。

适用场景:读取或写入 JSON 与属性列表的 iOS/Swift 应用、API 响应解析、持久化边界处理。

限制:仅目标 Swift 6.3 / iOS 26+;键策略只适用于机械式 snake_case 到 camelCase 映射,imageURL、baseURI、userID 等拼写需显式 CodingKeys;存储默认值不会让合成解码容忍缺失的非可选键;有损数组仅在部分成功属于产品契约时使用;未提供收费、价格与平台等信息。