SwiftUI中@AppStorage存储数组新增元素与属性的兼容方案

问题根因 #

两个兼容问题的核心原因如下：

• @AppStorage的默认值仅在对应key从未被写入过的时候生效，只要用户之前产生过存储数据，你修改代码里的默认数组不会同步到用户本地，新增的元素自然不会出现。
• 当前使用的JSON解码为严格模式，Codable结构体新增非可选存储属性时，旧存档数据缺少对应字段会直接解码失败，导致所有历史数据被清空。

具体解决方法 #

1. 解决新增默认数组元素不生效问题 #

不要依赖@AppStorage的内置默认值逻辑，改为启动时主动合并默认数据：

• 单独维护当前版本的基准默认数组，后续新增元素直接往这个数组里添加
• App每次启动时，对比本地已存储的数组和基准默认数组，按唯一id做差集，把用户本地缺失的新元素补入存储即可
• 合并逻辑仅追加缺失元素，不会覆盖用户已经修改过的旧元素属性

2. 解决结构体新增属性导致旧数据丢失问题 #

修改Codable结构体的解码逻辑，对新增属性做缺省兜底：

• 给结构体实现自定义解码方法，旧版本已经存在的属性保持严格解码，新增的属性使用decodeIfPresent解码，缺失时自动填充预设默认值
• 优化Array的RawRepresentable扩展，解码失败时返回空数组而非nil，避免极端情况下存储逻辑崩溃

完整实现代码 #

修正后的Number结构体（兼容属性新增） #

struct Number: Identifiable, Codable {
    var id: Int
    var number: Int
    var flag: Bool
    var description: String // 后续新增的属性直接在这里加

    // 便利初始化方法，方便构造默认数据
    init(id: Int, number: Int, flag: Bool = false, description: String = "abc") {
        self.id = id
        self.number = number
        self.flag = flag
        self.description = description
    }

    // 自定义解码，兼容旧版本存档
    enum CodingKeys: String, CodingKey {
        case id, number, flag, description
    }

    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        // 旧版本已有属性，严格解码保证数据正确性
        id = try container.decode(Int.self, forKey: .id)
        number = try container.decode(Int.self, forKey: .number)
        flag = try container.decode(Bool.self, forKey: .flag)
        // 新增属性做缺省兜底，旧数据无对应字段时使用默认值
        description = try container.decodeIfPresent(String.self, forKey: .description) ?? "abc"
    }
}

优化后的Array RawRepresentable扩展 #

extension Array: RawRepresentable where Element: Codable {
    public init?(rawValue: String) {
        guard let data = rawValue.data(using: .utf8) else {
            self = []
            return
        }
        // 解码失败时返回空数组，避免存储失效
        guard let result = try? JSONDecoder().decode([Element].self, from: data) else {
            self = []
            return
        }
        self = result
    }

    public var rawValue: String {
        guard let data = try? JSONEncoder().encode(self),
              let result = String(data: data, encoding: .utf8)
        else {
            return "[]"
        }
        return result
    }
}

存储定义与启动合并逻辑 #

// 当前版本的基准默认数组，后续新增元素直接添加到这里即可
let currentDefaultNumbers: [Number] = [
    Number(id: 0, number: 1),
    Number(id: 1, number: 1),
    Number(id: 2, number: 1),
    Number(id: 3, number: 1),
    Number(id: 4, number: 1) // 版本迭代新增的元素示例
]

// @AppStorage初始值设为空数组，启动后主动合并
@AppStorage("numbers") var storedNumbers: [Number] = []

// App启动时调用一次该方法即可（可在App结构体init、或首屏.onAppear中调用）
func syncDefaultNumbers() {
    let existingIds = Set(storedNumbers.map(\.id))
    // 筛选出用户本地缺失的新元素
    let missingItems = currentDefaultNumbers.filter { !existingIds.contains($0.id) }
    // 追加缺失元素，不修改用户已有的数据
    storedNumbers.append(contentsOf: missingItems)
}

后续迭代注意事项 #

• 新增默认数组元素时，只需往currentDefaultNumbers中添加对应项即可，启动时会自动同步到所有用户本地
• 给Number新增存储属性时，记得在CodingKeys中添加对应枚举值，同时在自定义解码方法中用decodeIfPresent做缺省兜底，即可保证旧数据正常解码
• 禁止修改已有元素的id，否则会导致重复添加或覆盖用户数据的问题

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