为UIColor实现Codable：Decodable扩展报错问题求助

这个问题我之前也碰到过！核心原因是UIColor是非final类，我来给你拆解一下并提供几种可行的解决方案：

为什么会报错？ #

Swift的协议规则中有个关键点：当你为非final类的扩展实现协议的指定初始化器（比如Decodable要求的init(from:)）时，必须把这个初始化器标记为required——但required初始化器只能在类的原始定义代码中添加，不能放在扩展里。

因为UIColor是可以被继承的非final类，扩展无法修改类的继承结构，编译器无法保证子类能正确继承或覆盖这个扩展里的required初始化器，所以直接报错阻止了你的操作。而Encodable只需要实现实例方法encode(to:)，不需要修改初始化器，所以扩展实现完全没问题。

解决方案1：利用UIColor的NSCoding能力实现编解码 #

UIColor本身继承自NSObject，已经遵守了NSCoding协议，我们可以利用它的归档/解归档能力来实现Encodable和Decodable，同时用便利初始化器避开required的限制：

import UIKit

// 实现Encodable
extension UIColor: Encodable {
    public func encode(to encoder: Encoder) throws {
        var container = encoder.singleValueContainer()
        // 将UIColor归档为Data
        let colorData = try NSKeyedArchiver.archivedData(withRootObject: self, requiringSecureCoding: false)
        try container.encode(colorData)
    }
}

// 实现Decodable
extension UIColor: Decodable {
    public convenience init(from decoder: Decoder) throws {
        let container = try decoder.singleValueContainer()
        let colorData = try container.decode(Data.self)
        // 从Data解归档回UIColor
        guard let decodedColor = try NSKeyedUnarchiver.unarchivedObject(ofClass: UIColor.self, from: colorData) else {
            throw DecodingError.dataCorruptedError(
                in: container,
                debugDescription: "无法从Data解析出有效的UIColor"
            )
        }
        // 调用UIColor的指定初始化器完成初始化
        self.init(cgColor: decodedColor.cgColor)
    }
}

解决方案2：自定义解码逻辑（比如解析Hex字符串） #

如果你想直接从自定义格式（比如Hex字符串）解码UIColor，同样可以用便利初始化器实现：

extension UIColor: Decodable {
    public convenience init(from decoder: Decoder) throws {
        let container = try decoder.singleValueContainer()
        let hexString = try container.decode(String.self)
        
        // 这里实现你自己的Hex字符串转UIColor逻辑
        func hexStringToColor(_ hex: String) -> UIColor? {
            var cleanedHex = hex.trimmingCharacters(in: .whitespacesAndNewlines).uppercased()
            if cleanedHex.hasPrefix("#") {
                cleanedHex.removeFirst()
            }
            guard cleanedHex.count == 6 else { return nil }
            
            var rgbValue: UInt64 = 0
            Scanner(string: cleanedHex).scanHexInt64(&rgbValue)
            
            return UIColor(
                red: CGFloat((rgbValue & 0xFF0000) >> 16) / 255.0,
                green: CGFloat((rgbValue & 0x00FF00) >> 8) / 255.0,
                blue: CGFloat(rgbValue & 0x0000FF) / 255.0,
                alpha: 1.0
            )
        }
        
        guard let color = hexStringToColor(hexString) else {
            throw DecodingError.dataCorruptedError(
                in: container,
                debugDescription: "无效的Hex颜色字符串：\(hexString)"
            )
        }
        self.init(cgColor: color.cgColor)
    }
}

解决方案3：使用包装结构体（不直接扩展UIColor） #

如果你不想直接修改UIColor的扩展，可以创建一个包装结构体来处理编解码：

struct CodableColor: Codable {
    let rawValue: UIColor
    
    init(_ color: UIColor) {
        self.rawValue = color
    }
    
    init(from decoder: Decoder) throws {
        let container = try decoder.singleValueContainer()
        let colorData = try container.decode(Data.self)
        guard let color = try NSKeyedUnarchiver.unarchivedObject(ofClass: UIColor.self, from: colorData) else {
            throw DecodingError.dataCorruptedError(in: container, debugDescription: "无法解析UIColor")
        }
        self.rawValue = color
    }
    
    func encode(to encoder: Encoder) throws {
        var container = encoder.singleValueContainer()
        let colorData = try NSKeyedArchiver.archivedData(withRootObject: rawValue, requiringSecureCoding: false)
        try container.encode(colorData)
    }
}

// 使用示例
struct Theme: Codable {
    let primaryColor: CodableColor
}

// 转换
let redColor = CodableColor(UIColor.red)
let theme = Theme(primaryColor: redColor)

以上几种方法都能解决你遇到的问题，你可以根据自己的需求选择最合适的方案~

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