自定义Xib按钮在视图层级调试器正常 模拟器不显示且不随StackView自适应

问题产生原因 #

1. 自定义按钮初始化逻辑存在约束冲突：你在_init方法中同时给contentView设置了autoresizingMask和手动匹配父视图的约束，两套规则同时生效会生成冲突的约束，系统运行时会选择优先级更高的约束生效，导致尺寸不符合预期。View Hierarchy Debugger会展示最终约束计算的正确结果，但运行时因为约束冲突会出现渲染异常，就是你看到的两者不一致的情况。
2. 自定义按钮没有关闭自动约束转换：代码初始化的UIView子类默认translatesAutoresizingMaskIntoConstraints为true，你没有主动将其设为false，即使添加到StackView中，也可能保留了初始frame生成的固定宽高约束，导致尺寸无法跟随StackView自适应。
3. 按钮的固有内容尺寸计算异常：如果你的Xib内部的标签、控件没有做好上下左右的约束，按钮无法正确计算intrinsicContentSize，StackView在做fill equally布局时无法拿到正确的内容尺寸参考，就会出现按钮消失或者尺寸固定的问题。

解决步骤 #

第一步：修正自定义按钮的初始化逻辑 #

修改_init方法，移除重复的约束设置，同时主动关闭自动约束转换：

private func _init() {
    Bundle.main.loadNibNamed("MyCustomButton", owner: self, options: nil)
    // 先关闭自动约束转换
    self.translatesAutoresizingMaskIntoConstraints = false
    contentView.translatesAutoresizingMaskIntoConstraints = false
    
    self.addSubview(self.contentView)
    // 移除autoresizingMask设置，直接用约束匹配
    NSLayoutConstraint.activate([
        contentView.topAnchor.constraint(equalTo: topAnchor),
        contentView.leadingAnchor.constraint(equalTo: leadingAnchor),
        contentView.trailingAnchor.constraint(equalTo: trailingAnchor),
        contentView.bottomAnchor.constraint(equalTo: bottomAnchor)
    ])
    
    setTitle(nil, for: .normal)
    // 移除原来的matchConstraints调用，避免重复加约束
    decorate()
}

第二步：检查Xib内部的约束 #

打开MyCustomButton.xib，确保内部的所有控件（标题标签、副标题标签等）都有完整的上下左右约束，能够撑起来整个contentView的尺寸，保证按钮可以正确计算固有内容大小。

第三步：优化ViewController的渲染逻辑 #

移除不必要的layoutIfNeeded调用，避免先加视图再删除的多余操作：

func render(viewModel: ViewModel) {
    let rentalButton = MyCustomButton(frame: .zero)
    let shiftingButton = MyCustomButton(frame: .zero)
    rentalButton.titleText = "Rental button"
    shiftingButton.titleText = "Shifting button"
    rentalButton.subtitleText = "subtitle rental"
    shiftingButton.subtitleText = "subtitle shifting"
    
    // 清空原有视图
    for view in stackView.arrangedSubviews {
        stackView.removeArrangedSubview(view)
        view.removeFromSuperview()
    }
    
    let black = UIView()
    black.backgroundColor = .black
    let red = UIView()
    red.backgroundColor = .red
    
    // 仅组装需要显示的视图数组
    var arrangedViews: [UIView] = []
    if viewModel.showHouseShifting {
        arrangedViews.append(shiftingButton)
        shiftingButton.showSubtitle = true
    }
    arrangedViews.append(black)
    if viewModel.showRental {
        arrangedViews.append(rentalButton)
        rentalButton.showSubtitle = true
    }
    arrangedViews.append(red)
    
    arrangedViews.forEach { stackView.addArrangedSubview($0) }
    // 不需要手动调用layoutIfNeeded，StackView会自动处理布局
}

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