如何避免UITableView插入新Cell时自动滚动（聊天APP场景）

我完全懂你的烦恼——做聊天APP时，为了实现倒序显示把TableView翻转，结果插入新消息时，只要不在最底部就会自动滚动，打断用户看历史消息的体验。咱们来一步步搞定这个问题：

核心问题分析 #

你当前的判断逻辑contentOffset.y > -contentInset.top可能不够精准，而且用reloadData()会丢失动画，体验生硬。更好的思路是：插入新行后，只在用户本来就在底部时自动滚动，否则保持原来的滚动位置，这样既保留插入动画，又不会打扰用户。

具体解决方案 #

1. 精准判断是否处于列表最底部 #

先写一个辅助方法，准确判断用户是否正在查看最新消息（也就是列表最底部）。因为TableView被CGAffineTransform(scaleX: 1, y: -1)翻转了，坐标系是反向的，所以判断逻辑要适配这个变化：

private func isAtBottom() -> Bool {
    guard let tableView = self as? UITableView else { return false }
    
    // 计算翻转后，列表最底部对应的contentOffset阈值（加1的误差避免精度问题）
    let threshold = -tableView.contentInset.top + 1
    // 判断当前contentOffset是否接近最底部
    return tableView.contentOffset.y >= threshold
}

或者更严谨一点，结合可见行判断，确保用户确实能看到最新消息：

private func isAtBottom() -> Bool {
    guard let tableView = self as? UITableView,
          let visibleRows = tableView.indexPathsForVisibleRows else { return false }
    
    // 翻转后第0行是最新消息，判断它是否在可见范围内，同时滚动位置接近底部
    let isLatestMessageVisible = visibleRows.contains(IndexPath(row: 0, section: 0))
    let isScrollPositionAtBottom = tableView.contentOffset.y >= -tableView.contentInset.top - 1
    
    return isLatestMessageVisible && isScrollPositionAtBottom
}

2. 优化add方法：插入后保持滚动位置 #

修改你的add(_ item: Item)方法，不再用reloadData()，而是插入行后根据情况恢复滚动位置：

func add(_ item: Item) {
    guard let tableView = self as? UITableView else { return }
    
    // 先记录当前是否在底部
    let shouldScrollToNewMessage = isAtBottom()
    
    // 插入数据到数组
    items.insert(item, at: 0)
    
    // 执行插入行动画，确保布局稳定
    tableView.performBatchUpdates({
        tableView.insertRows(at: [IndexPath(row: 0, section: 0)], with: .top)
    }, completion: { [weak self] _ in
        guard let self = self else { return }
        
        if !shouldScrollToNewMessage {
            // 不在底部：恢复原来的滚动位置，抵消插入新行带来的偏移
            tableView.layoutIfNeeded() // 确保cell高度计算准确
            let newCellHeight = tableView.rectForRow(at: IndexPath(row: 0, section: 0)).height
            // 翻转后插入新行，contentOffset需要减去新cell高度来保持原位置
            tableView.contentOffset = CGPoint(
                x: tableView.contentOffset.x,
                y: tableView.contentOffset.y - newCellHeight
            )
        } else {
            // 在底部：自动滚动到新消息（确保显示完整）
            tableView.scrollToRow(at: IndexPath(row: 0, section: 0), at: .bottom, animated: true)
        }
    })
}

3. 额外注意点 #

• 用performBatchUpdates包裹插入操作，确保动画和布局更稳定；
• 调用layoutIfNeeded()保证能获取到新cell的准确高度，避免计算偏差；
• 阈值判断加入±1的误差，避免因为浮点精度问题导致判断错误；
• 如果你用的是泛型包装类，记得把tableView的引用正确传递，或者让包装类持有tableView的弱引用。

为什么这个方案有效？ #

• 不再生硬地调用reloadData()，保留了新消息插入的动画效果；
• 精准判断用户是否需要自动滚动，只有在用户本来就在看最新消息时才滚动，其他情况保持原位置；
• 通过调整contentOffset抵消插入新行带来的滚动偏移，完美解决了历史消息被打断的问题。

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