UITableViewCell横向双UILabel布局首次加载异常求助

问题原因分析 #

1. 布局代码调用时机错误：将setupUI()放在setSelected(_:animated:)方法中，该方法仅在Cell被选中/取消选中时触发。首次加载时Cell未被选中，布局代码不会执行；Cell复用（滚动时）若曾被选中，setupUI()会重复调用，导致子视图被多次添加，产生约束冲突，引发布局异常。
2. 宽度约束依赖未确定的frame值：locationNameView的宽度约束使用contentView.frame.width - 50，但Cell初始化阶段contentView的frame尚未由AutoLayout计算完成，此时宽度值不准确，导致首次加载时容器宽度异常；滚动后Cell的frame已确定，复用后约束效果符合预期。
3. 未开启TableView自动行高：未配置TableView自动计算行高，Cell高度无法根据动态内容自适应，进一步加剧布局错乱。

解决方案 #

1. 调整布局代码调用时机 #

将布局初始化代码移至Cell的初始化方法中，确保Cell创建时仅执行一次布局：

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

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

override func setSelected(_ selected: Bool, animated: Bool) {
    super.setSelected(selected, animated: animated)
    // 移除此处的setupUI()调用
}

2. 修改宽度约束为相对约束 #

替换locationNameView的固定宽度约束为相对于contentView的相对约束，避免依赖未确定的frame值：

// 替换原有的locationNameView.widthAnchor约束
locationNameView.widthAnchor.constraint(equalTo: contentView.widthAnchor, constant: -50),

3. 开启TableView自动行高 #

在TableView配置代码中设置自动行高，确保Cell高度随内容自适应：

// 在viewDidLoad或TableView初始化后添加
tableView.rowHeight = UITableView.automaticDimension
tableView.estimatedRowHeight = 250 // 设置接近实际行高的估算值，提升性能

4. 内容更新后触发布局刷新 #

在configure方法末尾添加布局刷新代码，确保内容更新后Cell重新计算布局：

func configure(model: LocationAndPhotoModel) {
    // 原有代码...
    
    // 触发布局刷新
    layoutIfNeeded()
}

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