UITableView调用reloadSections后出现滚动偏移异常问题求助

我来帮你解决这个UITableView偏移的问题——这个坑我之前做项目的时候踩过好几次！你遇到的情况是：当第1个section包含大量条目时，调用reloadSections刷新后，TableView会自动滚动到底部，出现偏移错误。本质原因是UITableView在处理整section刷新且行数变化较大时，内部的自动滚动对齐逻辑会“跑偏”，它试图将刷新后的section的某个位置对齐到可视区域，但因为行数太多，直接滚到了底部。

下面给你几个靠谱的解决方案，按推荐程度排序：

方案1：记录并恢复滚动偏移量 #

这是最直接的方法——在刷新前保存当前的滚动位置，刷新完成后强制恢复回去，不让系统乱调整。修改你的showHideAssets方法如下：

func showHideAssets() {
    // 先记录当前的滚动偏移
    let currentOffset = tableView.contentOffset
    isOpenHiddenAssets = !isOpenHiddenAssets
    
    tableView.beginUpdates()
    tableView.reloadSections(IndexSet(integer: 1), with: .fade)
    tableView.endUpdates()
    
    // 强制tableView完成布局后恢复偏移（必须加layoutIfNeeded，否则可能不生效）
    tableView.layoutIfNeeded()
    tableView.setContentOffset(currentOffset, animated: false)
}

这个方法的好处是改动最小，不需要修改你的数据源逻辑，直接在原有代码基础上增加两行即可。

方案2：用插入/删除行替代整Section刷新 #

如果方案1偶尔还是有问题，可以试试这个更精准的方式：不要直接刷新整个section，而是计算需要插入或删除的具体行，让UITableView知道确切的行数变化，这样它的布局计算会更准确。示例代码如下：

func showHideAssets() {
    isOpenHiddenAssets = !isOpenHiddenAssets
    
    // 先获取刷新前后的行数
    let oldRowCount = tableView.numberOfRows(inSection: 1)
    // 这里替换成你实际计算新行数的逻辑，比如：
    let newRowCount = isOpenHiddenAssets ? hiddenAssetsArray.count : 0
    
    tableView.beginUpdates()
    if newRowCount > oldRowCount {
        // 计算需要插入的行的IndexPath
        let insertIndexPaths = (oldRowCount..<newRowCount).map { 
            IndexPath(row: $0, section: 1) 
        }
        tableView.insertRows(at: insertIndexPaths, with: .fade)
    } else {
        // 计算需要删除的行的IndexPath
        let deleteIndexPaths = (newRowCount..<oldRowCount).map { 
            IndexPath(row: $0, section: 1) 
        }
        tableView.deleteRows(at: deleteIndexPaths, with: .fade)
    }
    tableView.endUpdates()
}

这种方式更符合UITableView的设计逻辑，因为系统能明确知道哪些行被添加或移除，不会出现莫名的滚动偏移，同时动画也会更流畅。

方案3：临时关闭自动滚动调整 #

如果上面两种方法都不适用，可以尝试临时关闭UITableView的自动滚动调整属性，刷新完成后再恢复：

func showHideAssets() {
    isOpenHiddenAssets = !isOpenHiddenAssets
    
    // 临时关闭自动调整
    tableView.automaticallyAdjustsScrollIndicatorInsets = false
    let currentOffset = tableView.contentOffset
    
    tableView.beginUpdates()
    tableView.reloadSections(IndexSet(integer: 1), with: .fade)
    tableView.endUpdates()
    
    // 恢复偏移和自动调整
    tableView.setContentOffset(currentOffset, animated: false)
    tableView.automaticallyAdjustsScrollIndicatorInsets = true
}

这个方法是通过禁用系统的自动调整逻辑，强制保留用户的滚动位置，适合一些特殊场景。

额外提醒 #

如果你的UITableView用了动态行高，建议在恢复偏移前确保行高已经正确计算，比如可以提前调用tableView.sizeToFit()或者确保cell的约束是完整的，避免因为行高计算延迟导致偏移恢复不准确。

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