无法为UIButton添加子视图：自定义子视图不显示求助

核心问题 #

你的自定义按钮ButtonWithSubview没有实现init(type: UIButton.ButtonType)初始化方法，而你创建按钮时使用的是.custom类型（ButtonWithSubview(.custom)），触发的是这个初始化器，而非你重写的init(frame:)。这导致prepareCustomView()根本没有执行，自定义子视图从未被添加到按钮上，所以在Debug View Hierarchy中也找不到它。

此外，原prepareCustomView()中的约束存在错误：重复添加了bottomAnchor约束，且缺少rightAnchor约束，即使方法执行也会导致布局异常。

修复代码 #

1. 修改自定义Button类

统一初始化逻辑，添加init(type:)方法，并修正约束：

public class ButtonWithSubview: UIButton {
    
    private var customView = UIView()
    
    override public init(frame: CGRect) {
        super.init(frame: frame)
        commonInit()
    }
    
    // 新增处理.custom类型的初始化方法
    public init(type: UIButton.ButtonType) {
        super.init(type: type)
        commonInit()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    // 统一初始化逻辑，避免重复代码
    private func commonInit() {
        backgroundColor = UIColor.Player.roundedButtonBackground.withAlphaComponent(0.75)
        prepareCustomView()
    }
    
    private func prepareCustomView() {
        customView.backgroundColor = UIColor.red.withAlphaComponent(0.8)
        customView.translatesAutoresizingMaskIntoConstraints = false
        self.addSubview(customView)
        
        // 修正约束：移除重复的bottom约束，添加right约束
        NSLayoutConstraint.activate([
            customView.topAnchor.constraint(equalTo: self.topAnchor),
            customView.leftAnchor.constraint(equalTo: self.leftAnchor),
            customView.bottomAnchor.constraint(equalTo: self.bottomAnchor),
            customView.rightAnchor.constraint(equalTo: self.rightAnchor)
        ])
        
        // 可选：将自定义视图置于底层，避免遮挡按钮的图片/文字
        self.sendSubviewToBack(customView)
    }
}

额外说明 #

• 确保所有可能的初始化路径（frame、type、coder）都能触发自定义初始化逻辑，避免遗漏子视图的添加流程。
• 使用NSLayoutConstraint.activate()替代addConstraints()是更推荐的约束激活方式，性能和可读性更好。
• 如果需要按钮的默认内容（图片、文字）显示在自定义子视图上方，调用sendSubviewToBack(customView)可避免遮挡。

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