iOS 15 Swift中UITableView自适应单元格UILabel高度异常求助

核心问题分析与解决步骤 #

1. 移除UILabel子类中的sizeToFit()调用 #

你的CellTextLabel在configure()方法中调用了sizeToFit()，这会在初始化时强制给Label设置基于空文本的初始frame，干扰AutoLayout的自动计算逻辑。初始渲染时Label的frame被错误固定，导致高度计算异常；滚动复用单元格时，AutoLayout重新计算才纠正了高度。

修改CellTextLabel的configure()方法：

private func configure() {
    adjustsFontForContentSizeCategory = true
    minimumScaleFactor = 0.5
    lineBreakMode = .byWordWrapping
    numberOfLines = 0
    // 移除 sizeToFit()
}

2. 修复UITableView的estimatedRowHeight配置 #

仅返回UITableView.automaticDimension不够，需要明确设置estimatedRowHeight给系统一个初始参考高度，避免布局计算偏差。在setupTableView()中添加：

tableView.rowHeight = UITableView.automaticDimension
tableView.estimatedRowHeight = 60 // 根据单元格实际高度设置合理值

注：无需单独实现heightForRowAt返回automaticDimension，直接设置tableView.rowHeight更简洁，效果一致。

3. 消除StatusLabel的垂直约束冲突 #

你的statusLabel同时设置了centerY.equalToSuperview()和top/bottom对齐name/teamLabel的约束，单元格高度变化时会产生冲突，导致布局引擎优先满足centerY，进而拉伸nameLabel的高度。

保留top和bottom约束，移除centerY约束，让statusLabel高度自动匹配name+team的垂直范围：

statusLabel.snp.makeConstraints { make in
    // 移除 make.centerY.equalToSuperview()
    make.trailing.equalTo(pointsLabel.snp.leading).offset(-12)
    make.top.equalTo(nameLabel.snp.top)
    make.bottom.equalTo(teamLabel.snp.bottom)
    make.width.greaterThanOrEqualTo(50)
}

如果需要statusLabel文本垂直居中，UILabel默认已支持，无需额外设置。

4. 修复TableHeaderView的约束问题 #

视图调试器的"Scrollable content size is ambigous"错误，源于同时给tableViewHeader设置frame和AutoLayout约束，导致tableView无法正确计算header高度。

修改setupTableView()中header的设置逻辑：

tableViewHeader.backgroundColor = UIColor.UI.background
// 直接设置frame，不添加额外约束
tableViewHeader.frame = CGRect(x: 0, y: 0, width: view.bounds.width, height: 50)
tableView.tableHeaderView = tableViewHeader

5. 强化Label的垂直布局优先级 #

给nameLabel和teamLabel设置更高的垂直压缩抵抗优先级，避免被其他视图拉伸：

// 在RaceResultCell的setupUI()中添加
nameLabel.setContentCompressionResistancePriority(.required, for: .vertical)
teamLabel.setContentCompressionResistancePriority(.required, for: .vertical)

验证步骤 #

1. 先移除sizeToFit()，这是初始布局错误的核心原因
2. 设置tableView的rowHeight和estimatedRowHeight
3. 调整statusLabel的约束消除冲突
4. 重新运行，观察初始渲染及滚动后的单元格状态

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