UITableView重载动画异常问题：动态高度可展开单元格行为异常

我太懂你遇到的这个坑了！当单元格只有顶部一小截露出屏幕的时候，调用reloadRows(at:with:)经常会出现滚动位置跳变、布局错乱甚至单元格短暂消失的情况，这其实是UITableView处理动态高度时的一个常见小bug。

问题根源 #

当单元格处于部分可见状态时，UITableView在重新加载它的过程中，会尝试自动调整contentOffset来保持单元格的可视位置，但因为展开/收缩后单元格高度发生了变化，这个自动调整的逻辑就会混乱，导致滚动偏移出现异常。

几个可靠的解决方案 #

方案1：记录并恢复滚动偏移

先把当前的滚动位置存下来，重载单元格后再强制恢复，避免系统自动调整偏移：

public func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    // 记录当前滚动偏移
    let currentOffset = tableView.contentOffset
    
    // 切换展开状态
    dataArray[indexPath.row].isExpanded = !dataArray[indexPath.row].isExpanded
    
    // 重载目标行
    tableView.reloadRows(at: [indexPath], with: .automatic)
    
    // 强制恢复之前的滚动位置
    tableView.layoutIfNeeded()
    tableView.setContentOffset(currentOffset, animated: false)
}

方案2：用beginUpdates() + endUpdates()替代reloadRows

这是我个人最常用的方法，UITableView的这组方法会自动计算单元格的高度变化，然后平滑更新布局，比单独调用reloadRows更稳定，动画也更自然：

public func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    dataArray[indexPath.row].isExpanded = !dataArray[indexPath.row].isExpanded
    
    // 触发自动布局更新，无需手动指定重载行
    tableView.beginUpdates()
    tableView.endUpdates()
}

这个方法的好处是系统会自动处理高度变化带来的布局调整，不会出现滚动偏移的问题，而且代码更简洁。

方案3：先让单元格完全可见再操作

如果上面两种方法还是有问题，可以先把单元格滚动到完全可见的位置，再执行展开/收缩操作：

public func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    // 先滚动到目标单元格，确保完全可见
    tableView.scrollToRow(at: indexPath, at: .none, animated: false)
    
    // 切换展开状态
    dataArray[indexPath.row].isExpanded = !dataArray[indexPath.row].isExpanded
    
    // 重载行
    tableView.reloadRows(at: [indexPath], with: .automatic)
}

这个方法适合对滚动位置要求不那么严格的场景，能彻底避免部分可见时的布局计算错误。

额外注意事项 #

• 确保你已经正确设置了动态高度：给tableView设置estimatedRowHeight（比如tableView.estimatedRowHeight = 100），并把rowHeight设为UITableView.automaticDimension。
• 如果用了自定义单元格，要确保layoutSubviews()里的布局逻辑正确，所有子视图的约束都能正确计算出单元格的高度，这是动态高度的基础。

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