如何为@MainActor隔离的类添加Codable协议一致性支持？

当你给整个类标记@MainActor时，类的所有指定构造器、实例方法都会默认继承MainActor隔离性。而Codable协议中的init(from:)和encode(to:)的协议要求是非隔离的同步方法，二者隔离级别不匹配，因此触发编译器报错。

• 方案1：手动给编解码方法添加nonisolated标记（最常用）
  如果你的编解码逻辑只操作Sendable类型的属性（比如示例中的Int），可以直接给两个协议要求的方法加nonisolated关键字，解除其MainActor隔离性，匹配协议要求。

@MainActor final class MyClass: Codable {
    var value: Int
    
    enum CodingKeys: String, CodingKey {
        case value
    }
    
    nonisolated init(from decoder: Decoder) throws {
        let data = try decoder.container(keyedBy: CodingKeys.self)
        self.value = try data.decode(Int.self, forKey: .value)
    }
    
    nonisolated func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(value, forKey: .value)
    }
}

• 方案2：依赖编译器自动合成Codable实现
  如果不需要自定义编解码逻辑，你可以完全删掉手动写的CodingKeys、init(from:)、encode(to:)实现。Swift 5.7+版本的编译器会自动为全局Actor隔离、且所有存储属性都符合Codable的类型合成nonisolated的编解码实现，无需手动处理。

@MainActor final class MyClass: Codable {
    var value: Int
}

• 方案3：要求编解码必须在MainActor上下文执行
  如果你确定你的编解码操作只会在MainActor线程调用，需要保证方法运行在MainActor，可以在nonisolated的方法内部使用MainActor.assumeIsolated(_:)手动断言当前处于MainActor上下文：

@MainActor final class MyClass: Codable {
    var value: Int
    
    enum CodingKeys: String, CodingKey {
        case value
    }
    
    nonisolated init(from decoder: Decoder) throws {
        try MainActor.assumeIsolated {
            let data = try decoder.container(keyedBy: CodingKeys.self)
            self.value = try data.decode(Int.self, forKey: .value)
        }
    }
    
    nonisolated func encode(to encoder: Encoder) throws {
        try MainActor.assumeIsolated {
            var container = encoder.container(keyedBy: CodingKeys.self)
            try container.encode(value, forKey: .value)
        }
    }
}

注意：该方案如果在非MainActor上下文调用编解码方法，会直接触发运行时崩溃，请仅在你能完全控制调用上下文的场景下使用。

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