Swift中如何解决自定义类与系统嵌套类型的类名冲突问题

问题原因 #

在UIButton子类内部访问Configuration类型时，Swift的类型查找规则会优先命中UIKit中UIButton的嵌套结构体UIButton.Configuration，而非全局定义的自定义Configuration类，因此会报成员不存在的错误。

解决方案 #

1. 显式指定所属模块名 #

自定义Configuration默认定义在当前项目的主模块下，模块名与Xcode项目的「Product Module Name」一致，加模块名前缀即可明确访问全局自定义类：

import UIKit

class Configuration{
    static var name = "test"
}

class MyButton: UIButton{
    func test(){
        // 示例中假设项目模块名为MyApp，替换为你实际的模块名即可
        let name = MyApp.Configuration.name 
    }
}

2. 全局声明类型别名 #

不需要修改原Configuration类的命名，只需要在全局位置新增一个类型别名即可规避冲突：

// 可写在自定义Configuration类同文件的全局位置
typealias AppConfiguration = Configuration

class MyButton: UIButton{
    func test(){
        let name = AppConfiguration.name
    }
}

3. 放入自定义命名空间 #

你可以将项目全局通用的自定义类型统一收纳到自定义命名空间下，从根源避免和系统类型重名：

// 用空枚举做命名空间，无需实例化，使用成本低
enum AppNamespace {
    class Configuration{
        static var name = "test"
    }
}

class MyButton: UIButton{
    func test(){
        let name = AppNamespace.Configuration.name
    }
}

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