UITableViewCell动态高度适配问题：AutoLayout无法实现动态尺寸

我太懂这种卡在AutoLayout约束上的感觉了——其实核心就是要让AutoLayout能完整算出单元格的垂直高度，不能留约束缺口。结合你给出的ImageView布局要求，再补全双Label的常见场景，给你一套可直接落地的方案：

第一步：先开启TableView的自动高度计算 #

这是基础前提，必须告诉TableView放弃固定高度，跟着内容走：

// 在ViewController的viewDidLoad里配置
tableView.rowHeight = UITableView.automaticDimension
tableView.estimatedRowHeight = 100 // 给个合理的估计值就行，主要是提升滚动性能

第二步：按要求配置UIImageView约束 #

你的ImageView规则很明确，直接按下面的约束来：

• 左侧与contentView的leading边间距15
• 宽高固定为60×60
• 垂直方向与contentView居中对齐

第三步：补全两个UILabel的约束（通用场景） #

因为你没给出Label的具体布局，我按最常用的「ImageView右侧上下排列」来配置，核心是让Label的约束形成从contentView顶部到底部的完整链条：

第一个Label（比如标题）： #

• 左侧与ImageView的trailing边间距15
• 右侧与contentView的trailing边间距15
• 顶部与contentView的top边间距15
• 必须设置numberOfLines = 0 + lineBreakMode = .byWordWrapping（不然文字不会换行，高度固定死）

第二个Label（比如描述）： #

• 左侧与第一个Label的leading对齐
• 右侧与第一个Label的trailing对齐
• 顶部与第一个Label的bottom边间距8
• 底部与contentView的bottom边间距15
• 同样设置numberOfLines = 0 + lineBreakMode = .byWordWrapping

完整代码示例（纯代码创建Cell） #

class DynamicContentCell: UITableViewCell {
    // 初始化子视图
    private let iconImageView = UIImageView()
    private let titleLabel = UILabel()
    private let descLabel = UILabel()
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupSubviews()
        setupConstraints()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupSubviews()
        setupConstraints()
    }
    
    // 配置子视图样式
    private func setupSubviews() {
        // ImageView
        iconImageView.contentMode = .scaleAspectFit
        iconImageView.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(iconImageView)
        
        // 标题Label
        titleLabel.numberOfLines = 0
        titleLabel.lineBreakMode = .byWordWrapping
        titleLabel.font = .systemFont(ofSize: 16, weight: .semibold)
        titleLabel.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(titleLabel)
        
        // 描述Label
        descLabel.numberOfLines = 0
        descLabel.lineBreakMode = .byWordWrapping
        descLabel.font = .systemFont(ofSize: 14, weight: .regular)
        descLabel.textColor = .secondaryLabel
        descLabel.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(descLabel)
    }
    
    // 配置约束
    private func setupConstraints() {
        NSLayoutConstraint.activate([
            // ImageView约束
            iconImageView.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 15),
            iconImageView.widthAnchor.constraint(equalToConstant: 60),
            iconImageView.heightAnchor.constraint(equalToConstant: 60),
            iconImageView.centerYAnchor.constraint(equalTo: contentView.centerYAnchor),
            
            // 标题Label约束
            titleLabel.leadingAnchor.constraint(equalTo: iconImageView.trailingAnchor, constant: 15),
            titleLabel.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -15),
            titleLabel.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 15),
            
            // 描述Label约束
            descLabel.leadingAnchor.constraint(equalTo: titleLabel.leadingAnchor),
            descLabel.trailingAnchor.constraint(equalTo: titleLabel.trailingAnchor),
            descLabel.topAnchor.constraint(equalTo: titleLabel.bottomAnchor, constant: 8),
            descLabel.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -15)
        ])
    }
    
    // 数据绑定方法
    func configure(with icon: UIImage?, title: String, desc: String) {
        iconImageView.image = icon
        titleLabel.text = title
        descLabel.text = desc
    }
}

在ViewController里使用：

override func viewDidLoad() {
    super.viewDidLoad()
    tableView.register(DynamicContentCell.self, forCellReuseIdentifier: "DynamicContentCell")
    tableView.rowHeight = UITableView.automaticDimension
    tableView.estimatedRowHeight = 100
}

override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "DynamicContentCell", for: indexPath) as! DynamicContentCell
    // 替换成你的业务数据
    cell.configure(with: UIImage(named: "your-icon"), 
                   title: "这是一段很长的标题，用来测试多行显示效果，看看单元格会不会自动调整高度", 
                   desc: "这是描述文本，不管内容有多少行，单元格都会跟着内容撑开高度，完美适配动态尺寸需求")
    return cell
}

如果用Storyboard/XIB创建Cell的注意事项 #

1. 所有子视图必须放在contentView里，不能直接加到Cell上
2. 给ImageView设置好约束后，按上面的规则给两个Label加约束
3. 一定要检查contentView的约束：确保它的top/bottom/leading/trailing都和Cell对应边缘对齐（Storyboard有时会默认加奇怪的约束，导致高度计算错误）
4. 在属性面板给两个Label设置Lines = 0

常见坑排查 #

• 忘记设置Label的numberOfLines=0：这是最容易踩的坑，Label默认1行，不会换行，高度自然固定
• 垂直约束不完整：比如最后一个Label没和contentView的bottom加约束，AutoLayout不知道底部边界，就无法计算高度
• 给Cell或contentView设了固定高度：直接破坏动态高度逻辑，必须删掉固定高度约束
• 约束冲突：如果Xcode提示冲突，检查是不是重复设置了宽高，或者约束逻辑矛盾

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