Swift 4 JSONEncoder能否按结构体属性顺序输出JSON字典键？

当然可以实现！虽然JSON标准本身不要求键的顺序，但出于调试需求要保持结构体属性的定义顺序的话，我们可以通过自定义编码逻辑来实现。

方法一：手动实现encode(to:)方法（最可靠） #

最直接的方式是让你的结构体手动实现Encodable协议的encode(to:)方法，严格按照结构体属性的定义顺序来编码每个字段，而不是依赖系统自动合成的编码逻辑。

比如针对你给出的Example结构体，修改如下：

struct Example: Codable {
    let id: Int
    let name: String
    let createdAt: Date
    let comments: [String]
    
    // 自定义编码逻辑，严格按属性定义顺序编码
    func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        // 按照结构体里属性的顺序依次编码
        try container.encode(id, forKey: .id)
        try container.encode(name, forKey: .name)
        try container.encode(createdAt, forKey: .createdAt)
        try container.encode(comments, forKey: .comments)
    }
}

这样编码后的JSON键顺序就会和你结构体里的属性顺序完全一致——id → name → createdAt → comments，完美满足调试时的可读性需求。

方法二：通过协议扩展批量处理（适合多结构体场景） #

如果你有很多结构体都需要这个功能，不想逐个手动写encode(to:)，可以定义一个自定义协议并实现扩展，利用Mirror来自动按属性顺序编码：

// 定义自定义协议，继承Codable
protocol OrderedCodable: Codable {}

extension OrderedCodable {
    func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        // 通过Mirror反射获取结构体的属性列表（保持定义顺序）
        let mirror = Mirror(reflecting: self)
        for child in mirror.children {
            // 过滤掉无标签的属性，匹配对应的CodingKey
            guard let propertyName = child.label,
                  let codingKey = CodingKeys(stringValue: propertyName) else {
                continue
            }
            // 对每个可编码的属性执行编码
            if let encodableValue = child.value as? Encodable {
                try encodableValue.encode(to: container.superEncoder(forKey: codingKey))
            }
        }
    }
}

之后只要让你的结构体遵循OrderedCodable即可：

struct Example: OrderedCodable {
    let id: Int
    let name: String
    let createdAt: Date
    let comments: [String]
}

注意：这个方式依赖属性名和自动生成的CodingKeys完全匹配，如果你的结构体自定义了CodingKeys（比如修改了键名），需要额外调整扩展逻辑来适配。

补充说明 #

系统默认的JSONEncoder之所以会打乱顺序，是因为它底层处理键值对时没有强制保留属性定义顺序（虽然Swift字典现在支持插入顺序，但Codable的默认实现并没有依赖这一点）。通过手动控制编码顺序，我们就能完全掌控JSON输出的键排列。

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