如何正确滚动UICollectionView至带预估高度的指定分区头部？

针对你遇到的「不可见分区头部预估高度与实际高度不一致导致滚动偏移错误」的问题，提供以下几种可行方案：

方案1：iOS 15+ 直接使用系统API #

iOS 15及以上的UICollectionView新增了专门的分区滚动API，会自动处理头部实际高度的计算，无需手动计算偏移，是最优解：

// 滚动到指定分区的顶部，确保头部显示在视口中
collectionView.scrollToSection(section, at: .top, animated: true)

方案2：兼容iOS 15以下版本 #

方法A：强制布局获取实际头部属性 #

通过触发布局计算，让系统生成目标分区头部的实际布局属性，再计算正确偏移：

let targetSection = section
// 触发目标分区的布局准备
collectionView.collectionViewLayout.prepareLayout()

if let headerAttrs = collectionView.collectionViewLayout.layoutAttributesForSupplementaryElement(
    ofKind: DocType.reuseIdentifier,
    at: IndexPath(item: 0, section: targetSection)
) {
    let offsetY = headerAttrs.frame.origin.y - collectionView.contentInset.top
    // 限制偏移范围，避免超出内容边界
    let safeOffsetY = max(0, min(offsetY, collectionView.contentSize.height - collectionView.bounds.height + collectionView.contentInset.bottom))
    collectionView.setContentOffset(CGPoint(x: 0, y: safeOffsetY), animated: true)
}

方法B：先滚动到分区首项再调整至头部 #

如果分区至少包含一个条目，可以先无动画滚动到首项，再基于实际头部视图调整偏移：

let firstItemIndexPath = IndexPath(item: 0, section: section)
// 先无动画滚动到分区第一个条目顶部
collectionView.scrollToItem(at: firstItemIndexPath, at: .top, animated: false)

// 获取已加载的头部视图，获取实际高度
if let headerView = collectionView.supplementaryView(forElementKind: DocType.reuseIdentifier, at: firstItemIndexPath) {
    let headerHeight = headerView.frame.height
    let targetOffsetY = collectionView.contentOffset.y - headerHeight - collectionView.contentInset.top
    collectionView.setContentOffset(CGPoint(x: 0, y: targetOffsetY), animated: true)
}

额外注意事项 #

• 确保你的UICollectionViewLayout正确实现了头部视图的高度计算逻辑（比如referenceSizeForHeaderInSection），避免预估高度与实际高度偏差过大。
• 若使用自定义布局，需确保layoutAttributesForSupplementaryElement(ofKind:at:)能返回准确的实际布局属性，而非仅预估属性。

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