Swift中如何将[String: Any]字典映射至自定义类？

嘿，这个需求我太熟了！手动挨个给属性赋值确实够烦的，尤其是属性多的时候。下面给你分享几个能自动根据属性名匹配字典键赋值的简便方案：

Swift的Mirror可以帮我们获取类的属性信息，结合KVC（键值编码）就能实现自动匹配赋值。这种方式不需要修改原有类的核心结构（只要继承NSObject），快速实现需求：

// 给NSObject扩展一个自动赋值的方法
extension NSObject {
    func populate(with dict: [String: Any]) {
        let objectMirror = Mirror(reflecting: self)
        // 遍历类的所有属性
        for (propertyName, _) in objectMirror.children {
            guard let key = propertyName, let value = dict[key] else {
                continue
            }
            // 检查类型是否匹配，避免类型不兼容导致的崩溃
            guard let currentValue = self.value(forKey: key) else {
                continue
            }
            let currentValueType = type(of: currentValue)
            if type(of: value) == currentValueType {
                self.setValue(value, forKey: key)
            }
        }
    }
}

// 你的自定义类（记得继承NSObject才能用KVC）
class MyClass: NSObject {
    var x = 0
    var y = "hi"
}

// 使用方式
let dict: [String: Any] = ["x": 1, "y": "hello"]
let classInstance = MyClass()
classInstance.populate(with: dict)
print(classInstance.x) // 输出1
print(classInstance.y) // 输出hello

注意：如果你的类不想继承NSObject，可以手动通过Mirror获取属性的setter来赋值，但实现起来会复杂一些，继承NSObject是最简便的方式。

如果追求类型安全和原生支持，推荐用Swift的Codable协议。这种方式更优雅，还能处理复杂的嵌套类型和可选值，出错时有明确的错误信息：

// 让自定义类遵守Codable协议
class MyClass: Codable {
    var x = 0
    var y = "hi"
}

// 字典转实例的通用方法
func convertDictToClass<T: Codable>(_ dict: [String: Any]) -> T? {
    do {
        let data = try JSONSerialization.data(withJSONObject: dict)
        let instance = try JSONDecoder().decode(T.self, from: data)
        return instance
    } catch {
        print("转换失败：\(error.localizedDescription)")
        return nil
    }
}

// 使用方式
let dict: [String: Any] = ["x": 1, "y": "hello"]
if let classInstance = convertDictToClass<MyClass>(dict) {
    print(classInstance.x) // 输出1
    print(classInstance.y) // 输出hello
}

这个方案的优势在于：自动处理类型匹配，不需要手动判断类型；如果字典里有多余的键或者缺失必要的键，会抛出明确的错误，方便调试。

如果你的项目已经在用第三方JSON解析库，比如ObjectMapper或者SwiftyJSON，也可以用它们来快速实现：

以ObjectMapper为例：

// 让类遵守Mappable协议
class MyClass: Mappable {
    var x = 0
    var y = "hi"
    
    required init?(map: Map) {}
    
    func mapping(map: Map) {
        x <- map["x"]
        y <- map["y"]
    }
}

// 使用方式
let dict: [String: Any] = ["x": 1, "y": "hello"]
let classInstance = MyClass(JSON: dict)

不过这个方案需要引入第三方库，如果只是简单需求，前两个原生方案足够。

内容的提问来源于stack exchange，提问作者J. Doe