如何用UILabel子类重写UIButton的titleLabel？CocoaPods验证遇警告

首先咱们得搞清楚这个警告的来龙去脉：你的代码在Swift里编译完全没问题，但CocoaPods验证时抛出的警告，本质是Swift和Objective-C的类型兼容性冲突——Swift允许属性重写时使用子类类型（协变特性），但Objective-C不支持这一点。自动生成的vieww-Swift.h头文件里，MyButton的titleLabel被声明为MyLabel *，而父类UIButton的titleLabel是UILabel *，OC编译器就会判定类型不兼容，抛出警告。

用自定义UILabel子类作为UIButton的titleLabel完全可行，只是需要处理好OC兼容性和按钮的视图生命周期，下面给你两种靠谱的解决方案：

方案一：兼容Objective-C的重写方式（推荐，适合需要支持OC调用的框架） #

这种方式既保留Swift里的子类类型，又让OC看到的属性类型和父类一致，彻底消除警告。

完整代码示例 #

class MyLabel: UILabel {
    // 这里放你的自定义逻辑，比如默认样式、文本绘制逻辑等
    override func drawText(in rect: CGRect) {
        // 举个例子：给文本添加内边距
        let insets = UIEdgeInsets(top: 4, left: 8, bottom: 4, right: 8)
        super.drawText(in: rect.inset(by: insets))
    }
}

class MyButton: UIButton {
    // 懒加载自定义label，确保只初始化一次
    private(set) lazy var customTitleLabel: MyLabel = {
        let label = MyLabel()
        label.translatesAutoresizingMaskIntoConstraints = false
        // 同步系统titleLabel的默认属性，避免样式不一致
        label.font = self.titleLabel?.font
        label.textColor = self.titleColor(for: .normal)
        label.textAlignment = .center
        return label
    }()

    override init(frame: CGRect) {
        super.init(frame: frame)
        setupCustomLabel()
    }

    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupCustomLabel()
    }

    // 替换系统默认的titleLabel为自定义label
    private func setupCustomLabel() {
        // 移除系统自带的titleLabel（如果已经创建）
        titleLabel?.removeFromSuperview()
        // 添加自定义label到按钮
        addSubview(customTitleLabel)
        // 设置约束，和系统titleLabel的布局逻辑对齐
        NSLayoutConstraint.activate([
            customTitleLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: titleEdgeInsets.left),
            customTitleLabel.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -titleEdgeInsets.right),
            customTitleLabel.topAnchor.constraint(equalTo: topAnchor, constant: titleEdgeInsets.top),
            customTitleLabel.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -titleEdgeInsets.bottom)
        ])
    }

    // 重写titleLabel，用@objc(type: UILabel)告诉OC这个属性的类型还是UILabel
    @objc(type: UILabel)
    override open var titleLabel: UILabel? {
        return customTitleLabel
    }

    // 重写title相关的设置方法，确保文本、颜色等设置到自定义label上
    override func setTitle(_ title: String?, for state: UIControl.State) {
        customTitleLabel.text = title
    }

    override func setTitleColor(_ color: UIColor?, for state: UIControl.State) {
        customTitleLabel.textColor = color
    }

    override func setTitleShadowColor(_ color: UIColor?, for state: UIControl.State) {
        customTitleLabel.shadowColor = color
    }
}

为什么这样可行？ #

• @objc(type: UILabel) 会让自动生成的OC头文件里，titleLabel的类型还是UILabel *，和父类UIButton的属性类型一致，完美避开警告。
• Swift代码里依然可以直接把titleLabel当作MyLabel使用（需要时可选绑定：if let myLabel = button.titleLabel as? MyLabel）。
• 通过替换系统titleLabel并同步布局、属性，保证按钮的行为和原生一致，同时加入自定义逻辑。

方案二：仅Swift使用的简化方式（适合纯Swift框架） #

如果你的框架不需要支持Objective-C调用，可以直接给重写的titleLabel添加@nonobjc，这样它就不会出现在OC头文件里，自然也不会有警告：

class MyButton: UIButton {
    private(set) var customTitleLabel: MyLabel!

    override init(frame: CGRect) {
        super.init(frame: frame)
        customTitleLabel = MyLabel()
        // 这里同样需要处理初始化、布局和属性同步逻辑，参考方案一的setupCustomLabel
        setupCustomLabel()
    }

    required init?(coder: NSCoder) {
        super.init(coder: coder)
        customTitleLabel = MyLabel()
        setupCustomLabel()
    }

    private func setupCustomLabel() {
        titleLabel?.removeFromSuperview()
        addSubview(customTitleLabel)
        // 添加约束...
    }

    // 用@nonobjc隐藏OC访问，同时指定返回类型为MyLabel?
    @nonobjc
    override open var titleLabel: MyLabel? {
        get { return customTitleLabel }
    }

    // 同样需要重写setTitle等方法...
}

注意事项 #

• 不管用哪种方案，都要确保自定义label的布局、属性和系统titleLabel对齐，避免出现样式或交互异常。
• 如果需要支持按钮的状态变化（比如高亮、选中），记得在setTitleColor等方法里处理不同状态的样式，或者直接给MyLabel添加状态管理逻辑。

内容的提问来源于stack exchange，提问作者J. Doe