Swift 5中如何实现UITableView滚动到底部单元格

算力阿峰

2026-10-2

问题原因

你当前的滚动实现直接设置了超过合法范围的contentOffset，部分场景下系统不会执行预期的滚动动作
调用滚动方法的时机错误：在数据源更新、reloadData执行后立刻调用时，tableView还没完成布局计算，contentSize仍为更新前的数值，会滚动到错误位置
动态cell高度的估算值不准确，导致tableView计算的contentSize存在偏差，滚动目标位置错误

修复方案

1. 替换为更可靠的滚动实现

优先使用系统提供的scrollToRow方法，自动适配tableView的布局参数，比手动计算contentOffset兼容性更好：

func scrollToBottom(animated: Bool = true) {
    let sectionCount = chatTableView.numberOfSections
    guard sectionCount > 0 else { return }
    let lastSection = sectionCount - 1
    let rowCount = chatTableView.numberOfRows(inSection: lastSection)
    guard rowCount > 0 else { return }
    let lastIndexPath = IndexPath(row: rowCount - 1, section: lastSection)
    chatTableView.scrollToRow(at: lastIndexPath, at: .bottom, animated: animated)
}

2. 修正滚动方法的调用时机

在数据源更新后，要等tableView完成布局计算再调用滚动方法，两种常用的正确写法：

常规reloadData场景

// 更新聊天数据源
chatMessages.append(newMsg)
chatTableView.reloadData()
// 异步到下一个runloop执行，此时tableView已完成内容计算
DispatchQueue.main.async {
    self.scrollToBottom()
}

批量更新场景

如果使用插入行的方式更新列表，在更新完成回调中调用：

chatTableView.performBatchUpdates({
    chatMessages.append(newMsg)
    let indexPath = IndexPath(row: chatMessages.count - 1, section: 0)
    chatTableView.insertRows(at: [indexPath], with: .automatic)
}, completion: { [weak self] _ in
    self?.scrollToBottom()
})