Swift中如何为Decodable模型可选字段设默认值？避免崩溃与冗余代码

这个问题我之前也碰到过，强制解包可选类型确实容易因为接口字段缺失导致崩溃，而且你提到的两种方案重复代码太多，维护起来太麻烦。这里有几个更优雅的替代方案，能帮你减少重复代码，同时彻底避免崩溃：

方案1：自定义解码初始化方法（让属性变为非可选） #

直接在模型的init(from decoder:)方法中处理默认值，把可选属性改成非可选类型，后续使用时完全不用考虑nil的问题：

struct Info: Decodable {
    let firstName: String
    let lastName: String
    
    enum CodingKeys: String, CodingKey {
        case firstName, lastName
    }
    
    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        // 尝试解码字段，缺失时返回默认空字符串
        firstName = try container.decodeIfPresent(String.self, forKey: .firstName) ?? ""
        lastName = try container.decodeIfPresent(String.self, forKey: .lastName) ?? ""
    }
}

之后在UITableViewCell中使用时，直接拼接即可，完全不用处理解包：

let person = personArray[indexPath.row]
personName.text = "\(person.firstName) \(person.lastName)"

优点：模型属性为非可选类型，使用时更安全，不会出现意外解包崩溃；解码逻辑集中在模型内部，符合单一职责。
缺点：如果模型有25个属性，需要在init中写25行类似的解码代码，但比你原来的方案还是简洁很多。

方案2：使用属性包装器（最优雅的复用方案） #

通过属性包装器封装“字段缺失时返回默认空字符串”的逻辑，新增属性时只需要添加一个注解即可，完全避免重复代码：

// 定义属性包装器，统一处理String类型的默认值逻辑
@propertyWrapper
struct DefaultEmptyString: Decodable {
    var wrappedValue: String
    
    init(from decoder: Decoder) throws {
        let container = try decoder.singleValueContainer()
        wrappedValue = try container.decodeIfPresent(String.self) ?? ""
    }
}

// 在模型中使用包装器
struct Info: Decodable {
    @DefaultEmptyString var firstName: String
    @DefaultEmptyString var lastName: String
    // 其他23个属性同样只需要加@DefaultEmptyString即可
}

使用方式和方案1一样，直接拼接非可选的属性值即可。

优点：代码复用性极强，新增属性零成本；解码逻辑统一维护，后续要修改默认值（比如改成"未知"）只需要修改包装器即可。
缺点：需要了解属性包装器的基本用法，但这是Swift中很实用的特性，值得掌握。

方案3：扩展Optional类型（快速解决，无需修改模型） #

如果你不想改动现有模型的结构，可以给String?扩展一个计算属性，快速获取默认空字符串：

extension Optional where Wrapped == String {
    // 给所有String?类型添加orEmpty属性，nil时返回空字符串
    var orEmpty: String {
        self ?? ""
    }
}

之后在UITableViewCell中使用时，调用这个属性即可：

let person = personArray[indexPath.row]
personName.text = "\(person.firstName.orEmpty) \(person.lastName.orEmpty)"

优点：完全不需要修改现有模型，代码量极少，适合快速修复问题；所有String?类型都能复用这个逻辑。
缺点：模型属性仍然是可选类型，使用时需要记得调用.orEmpty，如果忘记还是可能出现解包崩溃。

方案选择建议 #

• 如果你的模型属性数量多，且希望属性是安全的非可选类型，优先选方案2（属性包装器）；
• 如果不想引入属性包装器，或者只需要处理少数几个属性，选方案1（自定义解码）；
• 如果不想修改现有模型，只是临时解决崩溃问题，选方案3（Optional扩展）。

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