UITableViewCell自适应高度布局冲突及展开收起功能实现问题

首先得揪出那个UIView-Encapsulated-Layout-Height约束冲突的根源：这是系统给tableView自动生成的行高约束，优先级是1000，当我们自己写的自适应内容约束优先级和它一致时，就会“打架”。同时结合你要的展开收起需求，咱们一步步来解决：

一、先搞定约束冲突的核心操作 #

1. 调整内容约束的优先级 #

在自定义Cell里，给内容最底部的约束（比如文本标签的bottom到contentView的bottom）设置稍低的优先级（比如999），让系统的约束暂时“让步”，等内容变化时tableView能重新计算高度，不会触发冲突。

举个自定义Cell的代码示例：

class ExpandableCell: UITableViewCell {
    lazy var contentLabel: UILabel = {
        let label = UILabel()
        label.numberOfLines = 0 // 开启多行自适应
        label.translatesAutoresizingMaskIntoConstraints = false
        return label
    }()
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupCellLayout()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupCellLayout() {
        contentView.addSubview(contentLabel)
        
        NSLayoutConstraint.activate([
            contentLabel.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 16),
            contentLabel.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            contentLabel.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            // 关键：把底部约束优先级设为999，低于系统的1000
            contentLabel.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -16).priority(.defaultHigh)
        ])
    }
    
    // 配置内容和展开状态
    func setupContent(text: String, isExpanded: Bool) {
        contentLabel.numberOfLines = isExpanded ? 0 : 2 // 收起时显示2行，展开时显示全部
        contentLabel.text = text
    }
}

2. 可选：手动调整系统约束优先级 #

如果偶尔还是出现冲突，可以在Cell的layoutSubviews里主动修改系统约束的优先级：

override func layoutSubviews() {
    super.layoutSubviews()
    // 找到系统的高度约束并调整优先级
    contentView.constraints.forEach { constraint in
        if constraint.firstAttribute == .height && constraint.identifier == "UIView-Encapsulated-Layout-Height" {
            constraint.priority = .defaultHigh
        }
    }
}

二、实现选中展开/收起的逻辑 #

在ViewController里维护一个记录每个Cell展开状态的数组，点击时切换状态并刷新对应行（用reloadRows而不是reloadData，保留动画效果）。

1. 准备数据和状态管理 #

class ViewController: UIViewController {
    lazy var tableView: UITableView = {
        let tv = UITableView(frame: .zero, style: .plain)
        tv.register(ExpandableCell.self, forCellReuseIdentifier: "ExpandableCell")
        tv.delegate = self
        tv.dataSource = self
        // 开启自适应高度（你已经掌握的部分）
        tv.rowHeight = UITableView.automaticDimension
        tv.estimatedRowHeight = 80 // 设置接近收起状态的预估高度，提升滚动流畅度
        return tv
    }()
    
    // 示例内容数据
    private let cellContents = [
        "这是一段用来测试展开收起的长文本，点击单元格可以展开查看全部内容，再次点击就会收起，只显示前两行。自适应高度会根据内容自动调整，不会再出现约束冲突的问题。",
        "另一段测试文本，内容不算太长，但也能清晰展示展开收起的效果。确保单元格在两种状态下的高度都能正确计算。",
        "第三段超长测试文本，这里可以填充大量内容，比如介绍某个功能的详细用法、描述一个复杂的场景，验证展开后高度能否完整适配内容。"
    ]
    
    // 记录每个Cell的展开状态，默认都是收起（false）
    private var expandedStatus: [Bool] = []
    
    override func viewDidLoad() {
        super.viewDidLoad()
        view.addSubview(tableView)
        tableView.frame = view.bounds
        // 初始化状态数组
        expandedStatus = Array(repeating: false, count: cellContents.count)
    }
}

2. 实现TableView代理和数据源 #

extension ViewController: UITableViewDataSource, UITableViewDelegate {
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return cellContents.count
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "ExpandableCell", for: indexPath) as! ExpandableCell
        let content = cellContents[indexPath.row]
        let isExpanded = expandedStatus[indexPath.row]
        cell.setupContent(text: content, isExpanded: isExpanded)
        return cell
    }
    
    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        // 切换当前行的展开状态
        expandedStatus[indexPath.row].toggle()
        // 刷新当前行，自动重新计算高度
        tableView.reloadRows(at: [indexPath], with: .automatic)
        // 可选：取消选中状态
        tableView.deselectRow(at: indexPath, animated: true)
    }
}

三、额外注意点 #

• 确保Cell内所有子视图的约束是完整的：从top到bottom、leading到trailing都有明确约束，tableView才能正确计算自适应高度。
• 预估高度estimatedRowHeight尽量贴近收起状态的实际高度，减少滚动时的高度跳动。
• 如果Cell内有动态加载的内容（比如网络图片），加载完成后记得调用tableView.reloadRows(at:with:)更新高度。

这样操作后，既解决了约束冲突问题，又完美实现了单元格的展开收起+自适应高度功能。

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