UITableView单元格折叠动画效果不佳问题求助

针对你遇到的部分单元格折叠时先跳变再动画的问题，结合你的实现细节（固定行高、beginUpdates/endUpdates动画、大标题导航栏+TabBar环境），我整理了几个针对性的优化方案，你可以逐一尝试：

1. 调整滚动时机，避免与行高动画冲突 #

你当前在endUpdates后立即调用scrollToRow，这可能会打断行高更新的动画流程，导致布局跳变。建议把滚动操作放到批量更新的完成回调里，确保行高动画结束后再执行滚动：

func expandRow(at indexPath: IndexPath?) {
    let targetScrollIndex = indexPath
    selectedIndexPath = indexPath
    
    // 使用performBatchUpdates替代begin/endUpdates，利用完成回调控制时机
    tableView.performBatchUpdates({
        // 无需额外操作，批量更新会自动触发行高重计算
    }, completion: { [weak self] isFinished in
        guard let self = self, isFinished, let ip = targetScrollIndex else { return }
        self.tableView.scrollToRow(at: ip, at: .none, animated: true)
    })
}

2. 修复导航栏/TabBar带来的布局偏移干扰 #

大标题导航栏和TabBar会自动调整UITableView的contentInset，在行高动画期间，系统的自动调整可能会导致内容跳变。你可以手动固定contentInset，避免系统干扰：

步骤一：禁用自动inset调整 #

在viewDidLoad中设置：

// iOS 11+ 替代废弃的automaticallyAdjustsScrollViewInsets
tableView.contentInsetAdjustmentBehavior = .never
// 手动设置适配导航栏和TabBar的inset
let navBarHeight = navigationController?.navigationBar.frame.height ?? 0
let tabBarHeight = tabBarController?.tabBar.frame.height ?? 0
tableView.contentInset = UIEdgeInsets(top: navBarHeight, left: 0, bottom: tabBarHeight, right: 0)
tableView.scrollIndicatorInsets = tableView.contentInset

步骤二：动画期间保持inset稳定 #

在折叠/展开方法中临时锁定inset，动画完成后恢复（如果上面的全局设置已经解决问题，这一步可以省略）：

func expandRow(at indexPath: IndexPath?) {
    let targetScrollIndex = indexPath
    let originalInset = tableView.contentInset
    let originalIndicatorInset = tableView.scrollIndicatorInsets
    
    // 临时锁定inset
    tableView.contentInset = originalInset
    tableView.scrollIndicatorInsets = originalIndicatorInset
    
    selectedIndexPath = indexPath
    
    tableView.performBatchUpdates({
    }, completion: { [weak self] isFinished in
        guard let self = self else { return }
        // 恢复inset
        self.tableView.contentInset = originalInset
        self.tableView.scrollIndicatorInsets = originalIndicatorInset
        
        if isFinished, let ip = targetScrollIndex {
            self.tableView.scrollToRow(at: ip, at: .none, animated: true)
        }
    })
}

3. 确保预估行高与实际行高完全匹配 #

虽然你已经复用了行高计算方法，但预估行高的准确性直接影响UITableView的布局预计算。可以明确区分预估行高和实际行高的计算逻辑，避免偏差：

override func tableView(_ tableView: UITableView, estimatedHeightForRowAt indexPath: IndexPath) -> CGFloat {
    // 直接返回明确的预估高度，避免动态计算带来的误差
    return selectedIndexPath == indexPath ? 300 : 70
}

override func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
    if selectedIndexPath == indexPath {
        return 300 + CGFloat((indexPath.row % 4) * 20)
    } else {
        return 70
    }
}

这样做的好处是，预估行高用近似值快速布局，实际行高用精确值调整，减少动画过程中布局的突然修正。

4. 禁用UITableView的自动偏移调整 #

当行高变化时，UITableView会自动调整contentOffset以保持当前可见内容的位置，但在复杂的导航环境下，这个调整可能出错。你可以在动画前保存当前偏移，动画后手动恢复：

func expandRow(at indexPath: IndexPath?) {
    let targetScrollIndex = indexPath
    let originalOffset = tableView.contentOffset
    
    selectedIndexPath = indexPath
    
    tableView.performBatchUpdates({
    }, completion: { [weak self] isFinished in
        guard let self = self else { return }
        // 恢复原始偏移，再执行滚动（如果需要）
        self.tableView.contentOffset = originalOffset
        
        if isFinished, let ip = targetScrollIndex {
            self.tableView.scrollToRow(at: ip, at: .none, animated: true)
        }
    })
}

这些方案都是针对你的场景（iOS 11.3、iPhone 7模拟器、大标题导航栏+TabBar）设计的，你可以先尝试方案1和方案2，这两个解决了大部分类似的动画跳变问题。

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