Swift Codable：如何将字典键作为解码对象的属性

核心思路 #

原始JSON是键为颜色名称、值为颜色参数的字典结构，我们需要把字典的键提取为Color对象的属性，同时解码值里的a/b/c参数。实现分为两种方式：字典映射法（简单直接）和自定义Codable解码（规范封装）。

方法一：字典映射法 #

1. 定义数据结构

先定义两个结构体：ColorData匹配JSON中的颜色参数部分，Color包含名称和所有参数（可扩展补充信息）：

// 用于解码JSON中的a/b/c参数
private struct ColorData: Codable {
    let a: Int
    let b: Int
    let c: Int
}

// 最终的Color对象，包含名称与补充信息属性
struct Color {
    let name: String
    let a: Int
    let b: Int
    let c: Int
    let complementaryColorName: String?
}

2. 解码并转换

将整个JSON解码为[String: ColorData]字典，遍历字典生成Color实例：

// 假设jsonData是从文件/网络获取的Data对象
do {
    // 第一步：解码JSON为键值对字典
    let colorDataDict = try JSONDecoder().decode([String: ColorData].self, from: jsonData)
    
    // 第二步：转换为Color数组，同时设置补充信息
    let colors = colorDataDict.map { key, data -> Color in
        // 根据颜色名称设置互补色示例
        let complementary: String? = switch key {
        case "red": "blue"
        case "blue": "red"
        case "yellow": "purple"
        default: nil
        }
        return Color(
            name: key,
            a: data.a,
            b: data.b,
            c: data.c,
            complementaryColorName: complementary
        )
    }
    
    // 使用生成的colors数组
    print(colors)
} catch {
    print("解码失败：\(error)")
}

方法二：自定义Codable解码 #

如果希望完全遵循Codable协议的解码流程，可通过动态CodingKey封装整个逻辑：

struct ColorCollection: Codable {
    let colors: [Color]
    
    // 最终的Color对象
    struct Color: Codable {
        let name: String
        let a: Int
        let b: Int
        let c: Int
        let complementaryColorName: String?
    }
    
    // 动态CodingKey，用于遍历JSON的所有键
    private struct DynamicCodingKey: CodingKey {
        var stringValue: String
        init?(stringValue: String) { self.stringValue = stringValue }
        var intValue: Int?
        init?(intValue: Int) { return nil }
    }
    
    // 自定义解码初始化器
    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: DynamicCodingKey.self)
        var colors = [Color]()
        
        for key in container.allKeys {
            // 解码单个颜色的参数
            let colorData = try container.decode(ColorData.self, forKey: key)
            // 设置互补色
            let complementary: String? = switch key.stringValue {
            case "red": "blue"
            case "blue": "red"
            case "yellow": "purple"
            default: nil
            }
            // 创建Color实例并添加到数组
            colors.append(Color(
                name: key.stringValue,
                a: colorData.a,
                b: colorData.b,
                c: colorData.c,
                complementaryColorName: complementary
            ))
        }
        self.colors = colors
    }
    
    // 内部参数结构体
    private struct ColorData: Codable {
        let a: Int
        let b: Int
        let c: Int
    }
}

// 使用方式
do {
    let colorCollection = try JSONDecoder().decode(ColorCollection.self, from: jsonData)
    let colors = colorCollection.colors
    print(colors)
} catch {
    print("解码失败：\(error)")
}

关键说明 #

• 方法一更适合简单场景，代码简洁易懂；方法二更符合Codable的设计规范，便于统一管理解码逻辑。
• 补充信息（如互补色）可通过判断name属性灵活设置，后续可扩展更多自定义规则。

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