在iOS开发中，Json数据解析是和服务端交互的核心环节，生成正确的Json模型是保证数据准确传递的基础。很多开发者在初期会因为忽视细节导致模型解析失败，下面通过5个步骤帮你规范操作，避免常见错误。
第一步：分析Json数据结构
拿到后端返回的Json数据后，首先要完整梳理数据结构，明确每个字段的类型、是否存在可选值、是否有嵌套结构。比如下面是一段常见的用户数据Json：
{
"code": 200,
"message": "请求成功",
"data": {
"user_id": 12345,
"user_name": "张三",
"is_vip": true,
"tags": ["coding", "reading"],
"address": null
}
}需要明确code是Int类型，message是String类型，data是嵌套对象，其中user_id是Int，user_name是String，is_vip是Bool，tags是字符串数组，address是可选值可能为nil。
第二步：定义对应的模型类
根据分析好的结构定义模型类，Swift中推荐使用struct，并且遵循Codable协议，这样可以直接用系统提供的解析能力。定义时要注意字段名和Json的key完全对应，可选值用可选类型声明。
import Foundation
// 外层响应模型
struct ApiResponse: Codable {
let code: Int
let message: String
let data: UserData?
}
// 用户数据模型
struct UserData: Codable {
let userId: Int
let userName: String
let isVip: Bool
let tags: [String]
let address: String?
// 如果字段名和Json的key不一致，需要自定义CodingKeys
enum CodingKeys: String, CodingKey {
case userId = "user_id"
case userName = "user_name"
case isVip = "is_vip"
case tags
case address
}
}第三步：处理字段类型映射
实际开发中经常遇到Json字段类型和Swift常用类型不匹配的情况，比如服务端返回的时间戳是Int类型，而我们想转成Date类型，或者服务端返回的字符串数字想转成Int类型，这时候可以在模型里自定义解析逻辑。
struct UserData: Codable {
let userId: Int
let userName: String
let registerTime: Date
enum CodingKeys: String, CodingKey {
case userId = "user_id"
case userName = "user_name"
case registerTime = "register_time"
}
init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: CodingKeys.self)
userId = try container.decode(Int.self, forKey: .userId)
userName = try container.decode(String.self, forKey: .userName)
// 假设服务端返回的register_time是时间戳（秒）
let timeStamp = try container.decode(Int.self, forKey: .registerTime)
registerTime = Date(timeIntervalSince1970: TimeInterval(timeStamp))
}
func encode(to encoder: Encoder) throws {
var container = encoder.container(keyedBy: CodingKeys.self)
try container.encode(userId, forKey: .userId)
try container.encode(userName, forKey: .userName)
let timeStamp = Int(registerTime.timeIntervalSince1970)
try container.encode(timeStamp, forKey: .registerTime)
}
}第四步：执行Json解析并校验
模型定义完成后，用JSONDecoder执行解析，同时要做好错误处理，避免因为数据异常导致崩溃。解析完成后可以打印模型属性，校验每个字段的值是否符合预期。
func parseJsonData(jsonString: String) {
guard let jsonData = jsonString.data(using: .utf8) else {
print("Json字符串转Data失败")
return
}
let decoder = JSONDecoder()
do {
let response = try decoder.decode(ApiResponse.self, from: jsonData)
print("解析成功，code: \(response.code)")
if let userData = response.data {
print("用户ID: \(userData.userId)")
print("用户名: \(userData.userName)")
} else {
print("用户数据为空")
}
} catch {
print("解析失败，错误: \(error.localizedDescription)")
}
}第五步：边界场景测试
完成基础解析后，要测试各种边界场景，比如字段缺失、类型错误、值为null、数组为空等情况，确保模型能够正常处理，不会出现崩溃。可以构造不同的Json数据进行测试：
- 测试缺少某个非必填字段的情况，比如address字段不存在
- 测试字段类型错误的情况，比如user_id返回的是字符串而不是数字
- 测试值为null的情况，比如address为null
- 测试嵌套对象为空的情况，比如data字段为null
通过这5个步骤操作，就能规范生成iOS中的Json模型，减少解析过程中的常见错误，提升代码的稳定性和可维护性。