UITableView在索引0插入行时，轻微滚动后动画异常问题

问题现象 #

• 未滚动UITableView时，在索引0位置插入行，动画表现正常
• 轻微滚动列表（比如仅滚动1像素）后，再次插入顶部行，动画直接失效，且动画结束后contentOffset会出现明显跳变

解决方案 #

方案1：手动预调整contentOffset #

在执行插入操作前，提前将contentOffset偏移量加上新行的高度，让系统动画逻辑能正确计算视觉位置：

// 假设newRowHeight为插入行的高度，可通过tableView.rowHeight或自定义计算获取
let newRowHeight = tableView.rowHeight
let currentOffset = tableView.contentOffset

// 先更新数据源
dataSource.insert("新插入的行内容", at: 0)

// 预调整偏移量，抵消插入行带来的布局变化
tableView.contentOffset = CGPoint(x: currentOffset.x, y: currentOffset.y + newRowHeight)

// 执行插入动画
tableView.insertRows(at: [IndexPath(row: 0, section: 0)], with: .automatic)

如果列表存在contentInset，需要加入内边距的计算以保证准确性：

let newRowHeight = tableView.rowHeight
let topInset = tableView.contentInset.top
let adjustedYOffset = tableView.contentOffset.y + newRowHeight - topInset

dataSource.insert("新插入的行内容", at: 0)
tableView.contentOffset = CGPoint(x: tableView.contentOffset.x, y: adjustedYOffset)
tableView.insertRows(at: [IndexPath(row: 0, section: 0)], with: .automatic)

方案2：禁用自动偏移调整（iOS 11+） #

通过关闭adjustsContentOffsetForAutomaticScrolling属性，阻止系统自动调整偏移量，适合不需要系统自动维护滚动位置的场景：

if #available(iOS 11.0, *) {
    tableView.adjustsContentOffsetForAutomaticScrolling = false
}

问题原因 #

UITableView在用户手动滚动后，内部会标记当前contentOffset为用户主动设置的位置。当插入顶部行时，系统默认会尝试保持当前可见单元格的位置不变，但当滚动偏移量极小时，系统的动画计算逻辑出现偏差，导致动画失效，最终触发偏移量跳变。手动预调整偏移量相当于提前告知系统需要保持的视觉位置，让动画逻辑能正常执行。

内容的提问来源于stack exchange，提问作者Patryk Średziński