如何将Swift编译器合成的私有子类型设为内部或公开访问级别？

你遇到的这个场景太常见了——比如当类型遵循Codable时，编译器自动生成的CodingKeys枚举默认就是private，确实会卡住在同一模块跨文件扩展里访问的需求。好消息是，完全不需要手动编写子类型的实现，只需要显式声明它并指定更高的访问级别，编译器会继续帮你完成所有合成工作。

具体操作步骤 #

核心思路很简单：当你显式写出编译器原本会自动生成的子类型（比如CodingKeys），并给它指定一个更高的访问级别（比如internal，这是同一模块内的默认访问级别），编译器会检查该类型是否符合自动合成的条件，如果符合，就会自动填充所有必要的实现细节（比如Codable需要的枚举case），同时使用你指定的访问级别，而不是默认的private。

举个实际的例子，假设你有一个遵循Codable的User类：

// User.swift
class User: Codable {
    var name: String
    var age: Int
    
    // 显式声明CodingKeys为internal，不需要手动编写任何case
    internal enum CodingKeys: String, CodingKey {}
    
    init(name: String, age: Int) {
        self.name = name
        self.age = age
    }
}

现在在同一模块的另一个文件User+Extensions.swift里，你就能直接访问这个CodingKeys了：

// User+Extensions.swift
extension User {
    func printAllCodingKeys() {
        let keyNames = CodingKeys.allCases.map { $0.rawValue }
        print("All coding keys: \(keyNames)") // 输出 "All coding keys: ["name", "age"]"
    }
}

关键注意事项 #

• 访问级别不能超过父类型的访问级别：比如如果你的User类是internal（Swift默认的模块内访问级别），那么CodingKeys最多只能声明为internal，不能设为public；如果父类型本身是public，你可以把子类型声明为public来支持跨模块访问。
• 这个方法适用于所有编译器支持自动合成的子类型：除了Codable的CodingKeys，其他类似由编译器自动生成的嵌套类型（比如部分协议关联类型的默认实现类型）都可以用这种方式调整访问级别。

背后的原理 #

Swift编译器的自动合成逻辑会优先尊重你显式声明的类型结构——只要你声明的类型满足对应协议的要求（比如CodingKeys必须遵循String和CodingKey），编译器就会跳过默认的private合成流程，转而使用你指定的访问级别来生成必要的实现，完全省去了你手动编写所有枚举case或者子类型细节的麻烦。

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