UITableView自定义Cell中layoutIfNeeded重复调用两次的问题求助

嘿，这个问题我之前做项目时也踩过坑，咱们一步步来拆解原因和解决办法：

1. 为什么init里frame高度是44？ #

UITableView初始化cell的时候，会先给一个默认的44pt高度作为占位值——这是系统的默认行高。真正的自定义高度是在你实现的heightForRowAt方法返回后，tableView才会把这个正确高度赋值给cell的frame，所以在init阶段根本拿不到最终的行高，这个是正常的系统逻辑。

2. 为什么layoutIfNeeded会被调用两次？ #

layoutIfNeeded的作用是触发当前视图及其子视图的立即布局更新。当tableView把cell的frame更新为你计算的高度后，第一次调用是为了应用这个新frame；第二次大概率是因为cell内部的约束调整（比如你在setupViews里设置了label的锚点），触发了二次布局校验，或者tableView的内部复用/布局逻辑导致了重复调用。

3. 为什么layoutSubviews会被调用四次？ #

layoutSubviews是个非常“活跃”的方法，只要视图的frame变化、子视图增删、约束修改、屏幕旋转甚至tableView滚动时，都可能触发它。在cell的生命周期里，从初始化、高度赋值、复用准备到最终显示，系统可能会多次触发布局校验，四次调用其实是符合系统逻辑的，但我们可以控制自己的代码只执行一次。

核心思路是：不要依赖frame高度来做视图初始化/约束设置，改用AutoLayout让视图自适应，这才是iOS布局的正确打开方式。

方案1：用自动行高替代手动计算 #

完全不用自己写heightForRowAt，让系统根据cell内部的约束自动计算高度：

1. 在自定义cell里给label设置完整的约束（让label的高度自适应内容）：

override init(style: UITableViewCellStyle, reuseIdentifier: String?) {
    super.init(style: style, reuseIdentifier: reuseIdentifier)
    selectionStyle = .gray
    backgroundColor = .clear
    setupViews() // 初始化放在init里，只执行一次！
}

private func setupViews() {
    let audioLabel = UILabel()
    audioLabel.font = UIFont(name: "AvenirNext-Medium", size: 20)
    audioLabel.numberOfLines = 0 // 允许多行显示
    audioLabel.translatesAutoresizingMaskIntoConstraints = false
    contentView.addSubview(audioLabel)
    
    // 设置约束：让label上下左右都有间距，高度由内容决定
    NSLayoutConstraint.activate([
        audioLabel.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 8),
        audioLabel.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 8),
        audioLabel.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -8),
        audioLabel.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -8)
    ])
}

2. 在ViewController里开启自动行高：

override func viewDidLoad() {
    super.viewDidLoad()
    tableView.rowHeight = UITableView.automaticDimension
    tableView.estimatedRowHeight = 50 // 给个预估高度，提升滚动流畅度
}

这样系统会自动根据label的内容计算行高，你再也不用手动计算，也不会有布局重复调用的问题。

方案2：如果必须手动计算高度，避免重复执行代码 #

如果你因为某些原因一定要保留heightForRowAt的手动计算，可以给cell加个标记，让初始化代码只执行一次：

class CustomAudioCell: UITableViewCell {
    private var didSetupViews = false // 标记是否已经初始化过视图
    
    override init(style: UITableViewCellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        selectionStyle = .gray
        backgroundColor = .clear
    }
    
    override func layoutSubviews() {
        super.layoutSubviews()
        guard !didSetupViews else { return } // 已经初始化过就直接返回
        
        // 这里写需要根据frame高度调整的逻辑
        setupViews()
        didSetupViews = true
    }
    
    private func setupViews() {
        // 你的视图初始化和约束设置代码
    }
}

通过didSetupViews这个标记，哪怕layoutSubviews调用多次，setupViews也只会执行一次。

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