如何让高度可变的UITableView滚动后精准停在单元格顶部？

当UITableView使用自动计算高度（UITableView.automaticDimension）时，未布局单元格的预估高度与实际高度差异会导致直接设置targetContentOffset无法精准定位。以下是可靠的解决方法：

核心思路 #

避免直接依赖未布局单元格的frame.origin.y（基于预估高度），转而计算目标单元格顶部的准确偏移量，并在滚动结束后做二次修正，抵消高度变化带来的偏移误差。

具体实现步骤 #

1. 确定目标停靠的IndexPath #

根据滚动方向、速度或当前可见单元格，找出需要停靠的目标indexPath。示例逻辑：

private func determineTargetIndexPath(_ tableView: UITableView, velocity: CGPoint) -> IndexPath {
    let visibleRows = tableView.indexPathsForVisibleRows ?? []
    guard !visibleRows.isEmpty else { return IndexPath(row: 0, section: 0) }
    
    if velocity.y > 0 { // 向下滚动，停靠下一个单元格
        return visibleRows.last?.nextRow(in: tableView) ?? visibleRows.last!
    } else if velocity.y < 0 { // 向上滚动，停靠上一个单元格
        return visibleRows.first?.previousRow(in: tableView) ?? visibleRows.first!
    } else { // 无速度，停靠当前最接近顶部的单元格
        let currentOffset = tableView.contentOffset.y
        return visibleRows.min { tableView.rectForRow(at: $0).minY < tableView.rectForRow(at: $1).minY } ?? visibleRows.first!
    }
}

// 扩展IndexPath方便获取上下行
extension IndexPath {
    func nextRow(in tableView: UITableView) -> IndexPath? {
        let maxRow = tableView.numberOfRows(inSection: section) - 1
        guard row < maxRow else { return nil }
        return IndexPath(row: row + 1, section: section)
    }
    
    func previousRow(in tableView: UITableView) -> IndexPath? {
        guard row > 0 else { return nil }
        return IndexPath(row: row - 1, section: section)
    }
}

2. 计算目标单元格的准确顶部偏移 #

遍历目标行之前的所有单元格，累加实际高度总和（若单元格未加载，先创建并计算准确高度）：

private func getAccurateTopOffset(for indexPath: IndexPath, in tableView: UITableView) -> CGFloat {
    var totalOffset: CGFloat = 0
    
    // 累加目标section之前的所有section高度和行高
    for section in 0..<indexPath.section {
        totalOffset += tableView.rectForSection(section).height
        let rowCount = tableView.numberOfRows(inSection: section)
        for row in 0..<rowCount {
            let rowIndexPath = IndexPath(row: row, section: section)
            totalOffset += getRowHeight(for: rowIndexPath, in: tableView)
        }
    }
    
    // 累加目标section中目标行之前的行高
    for row in 0..<indexPath.row {
        let rowIndexPath = IndexPath(row: row, section: indexPath.section)
        totalOffset += getRowHeight(for: rowIndexPath, in: tableView)
    }
    
    return totalOffset
}

// 获取单元格的准确高度
private func getRowHeight(for indexPath: IndexPath, in tableView: UITableView) -> CGFloat {
    // 优先用已存在的单元格高度
    if let cell = tableView.cellForRow(at: indexPath) {
        cell.layoutIfNeeded()
        return cell.frame.height
    }
    
    // 单元格未加载时，创建并计算准确高度
    guard let cell = tableView.dequeueReusableCell(withIdentifier: "YourCellIdentifier") as? YourCustomCell else {
        return tableView.estimatedRowHeight
    }
    
    // 配置单元格数据（确保约束能计算准确高度）
    let cellData = yourDataSource[indexPath.section][indexPath.row]
    cell.configure(with: cellData)
    
    // 计算适配tableView宽度的准确高度
    let fittingSize = CGSize(width: tableView.bounds.width, height: UIView.layoutFittingCompressedSize.height)
    let cellHeight = cell.systemLayoutSizeFitting(fittingSize, withHorizontalFittingPriority: .required, verticalFittingPriority: .fittingSizeLevel).height
    
    // 更新预估高度，优化后续计算
    tableView.estimatedRowHeight = cellHeight
    
    return cellHeight
}

3. 设置目标偏移并做滚动后修正 #

在scrollViewWillEndDragging中设置目标偏移，同时在滚动结束后二次修正，确保精准定位：

private var pendingTargetIndexPath: IndexPath?

func scrollViewWillEndDragging(_ scrollView: UIScrollView, withVelocity velocity: CGPoint, targetContentOffset: UnsafeMutablePointer<CGPoint>) {
    guard let tableView = scrollView as? UITableView else { return }
    
    let targetIndexPath = determineTargetIndexPath(tableView, velocity: velocity)
    pendingTargetIndexPath = targetIndexPath
    
    let accurateOffsetY = getAccurateTopOffset(for: targetIndexPath, in: tableView)
    targetContentOffset.pointee.y = accurateOffsetY
}

func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
    finishScrollCorrection(scrollView)
}

func scrollViewDidEndScrollingAnimation(_ scrollView: UIScrollView) {
    finishScrollCorrection(scrollView)
}

private func finishScrollCorrection(_ scrollView: UIScrollView) {
    guard let tableView = scrollView as? UITableView, let targetIndexPath = pendingTargetIndexPath else { return }
    
    // 强制滚动到目标单元格顶部，修正高度变化导致的偏移误差
    tableView.scrollToRow(at: targetIndexPath, at: .top, animated: false)
    pendingTargetIndexPath = nil
}

关键注意事项 #

• 确保单元格约束完整：所有子视图的约束能从顶部到底部形成完整链条，让UITableView能自动计算准确高度。
• 合理设置预估高度：estimatedRowHeight设为接近实际高度的值，既能优化滚动性能，也能减少初始偏移误差。

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