自动高度UITableViewCell内UIStackView嵌套UILabel时高度歧义如何解决？

问题现象 #

运行时Xcode会报约束冲突警告，截图如下：

问题根源 #

当前布局歧义来自两个核心问题：

1. 两个UILabel的垂直方向**内容抗压缩优先级（Compression Resistance Priority）和内容拥抱优先级（Content Hugging Priority）**完全相同，Auto Layout计算cell高度时无法判断哪个label的内容展示优先级更高，因此触发约束冲突警告。
2. 没有为UILabel设置numberOfLines = 0，如果后续文本长度超过一行会出现截断，也会影响自动高度计算的准确性。

具体修复步骤 #

1. 在自定义Cell的setupView方法中，为两个UILabel设置垂直方向的优先级：
   比如业务上需要标题优先完整展示，就给titleLabel设置更高的垂直抗压缩优先级：

// 标题抗压缩优先级高于副标题
titleLabel.setContentCompressionResistancePriority(.defaultHigh + 1, for: .vertical)
subtitleLabel.setContentCompressionResistancePriority(.defaultHigh, for: .vertical)
// 标题内容拥抱优先级高于副标题
titleLabel.setContentHuggingPriority(.defaultHigh + 1, for: .vertical)
subtitleLabel.setContentHuggingPriority(.defaultHigh, for: .vertical)

2. 为两个UILabel设置numberOfLines为0，支持多行展示：

titleLabel.numberOfLines = 0
subtitleLabel.numberOfLines = 0

3. （可选优化）在控制器的viewDidLoad中给tableView设置预估行高，提升自动高度计算性能：

table.estimatedRowHeight = 44

4. （可选优化）可以给StackView增加上下左右边距，避免文本贴边显示，调整StackView的约束即可。

修改后的完整Cell代码 #

class Cell: UITableViewCell {

    var title: String? {
        didSet {
            titleLabel.text = title
        }
    }

    var subtitle: String? {
        didSet {
            subtitleLabel.text = subtitle
        }
    }

    let titleLabel = UILabel()
    let subtitleLabel = UILabel()

    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupView()
    }

    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    private func setupView() {
        // 配置Label支持多行
        titleLabel.numberOfLines = 0
        subtitleLabel.numberOfLines = 0
        // 配置优先级消除布局歧义
        titleLabel.setContentCompressionResistancePriority(.defaultHigh + 1, for: .vertical)
        subtitleLabel.setContentCompressionResistancePriority(.defaultHigh, for: .vertical)
        titleLabel.setContentHuggingPriority(.defaultHigh + 1, for: .vertical)
        subtitleLabel.setContentHuggingPriority(.defaultHigh, for: .vertical)
        
        let stackView = UIStackView()
        stackView.axis = .vertical
        stackView.alignment = .top
        stackView.distribution = .fill
        stackView.spacing = 8

        stackView.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(stackView)
        NSLayoutConstraint.activate([
            stackView.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            stackView.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            stackView.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -12),
            stackView.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 12)
        ])

        stackView.addArrangedSubview(titleLabel)
        stackView.addArrangedSubview(subtitleLabel)
    }
}

通用处理方案 #

针对UITableView自动高度+StackView的布局场景，避免约束歧义的通用规则如下：

• 所有需要多行展示的文本控件必须设置numberOfLines = 0
• 同方向StackView内的多个可拉伸/压缩视图，必须明确区分不同视图的内容抗压缩、内容拥抱优先级，不能出现同方向优先级完全相同的情况
• StackView必须和cell的contentView完成四边约束绑定，不能缺失任何方向的约束
• 不要给cell、contentView、StackView设置固定高度约束，高度必须由子视图内容自动撑开
• 建议给tableView设置合理的estimatedRowHeight值，提升列表滑动性能，避免高度计算异常

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