Swift项目中SwiftyUserDefaults的Decodable协议适配错误求助

错误原因分析 #

你遇到的Type 'Self' does not conform to protocol 'Decodable'和'DefaultsKeyedArchiverBridge' requires that 'Self' conform to 'Decodable'错误，本质是错误地为基础类型（Date/String/Int）手动指定了DefaultsKeyedArchiverBridge。SwiftyUserDefaults已经内置了这些基础类型的默认桥接实现，不需要手动扩展桥接协议，强行使用归档桥接会触发编译器的不必要校验（虽然这些类型本身遵循Codable，但写法冲突会导致报错）。

正确的基础类型默认值定义方式 #

直接通过DefaultsKeys扩展定义带默认值的键即可，无需手动处理桥接：

import SwiftyUserDefaults

extension DefaultsKeys {
    // Date类型默认值
    static let lastLoginDate = DefaultsKey<Date>("lastLoginDate", defaultValue: Date())
    // String类型默认值
    static let userName = DefaultsKey<String>("userName", defaultValue: "")
    // Int类型默认值
    static let userAge = DefaultsKey<Int>("userAge", defaultValue: 0)
}

// 使用示例
Defaults[.lastLoginDate] = Date()
print(Defaults[.userName])

如果之前写了类似下面的错误扩展，直接删除即可：

// 错误写法，必须删除
extension Date: DefaultsSerializable {
    public static var bridge: DefaultsBridge<Self> {
        return DefaultsKeyedArchiverBridge()
    }
}

UserDefaults管理替代方案 #

1. 原生UserDefaults扩展 #

无需第三方库，直接通过扩展封装键值对，类型安全且轻量：

extension UserDefaults {
    private enum Keys: String {
        case lastLoginDate, userName, userAge
    }
    
    var lastLoginDate: Date {
        get { object(forKey: Keys.lastLoginDate.rawValue) as? Date ?? Date() }
        set { set(newValue, forKey: Keys.lastLoginDate.rawValue) }
    }
    
    var userName: String {
        get { string(forKey: Keys.userName.rawValue) ?? "" }
        set { set(newValue, forKey: Keys.userName.rawValue) }
    }
    
    var userAge: Int {
        get { integer(forKey: Keys.userAge.rawValue) }
        set { set(newValue, forKey: Keys.userAge.rawValue) }
    }
}

// 使用示例
UserDefaults.standard.lastLoginDate = Date()
print(UserDefaults.standard.userName)

2. 封装Codable结构体批量存储 #

将所有配置项封装成一个Codable结构体，统一归档/解档，适合配置项较多的场景：

struct AppSettings: Codable {
    var lastLoginDate: Date = Date()
    var userName: String = ""
    var userAge: Int = 0
}

extension UserDefaults {
    private let settingsKey = "AppSettings"
    
    var appSettings: AppSettings {
        get {
            guard let data = data(forKey: settingsKey),
                  let settings = try? JSONDecoder().decode(AppSettings.self, from: data) else {
                return AppSettings()
            }
            return settings
        }
        set {
            guard let data = try? JSONEncoder().encode(newValue) else { return }
            set(data, forKey: settingsKey)
        }
    }
}

// 使用示例
var settings = UserDefaults.standard.appSettings
settings.userName = "Ahmad"
UserDefaults.standard.appSettings = settings

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