sectionHeadersPinToVisibleBounds为true时scrollToItem置顶单元格被遮挡如何解决？

这个问题很常见——当你开启了sectionHeadersPinToVisibleBounds让Header悬停在顶部后，使用scrollToItem(at: .top)会把目标Item的顶部对齐到CollectionView的顶部，而悬停的Header刚好会覆盖在这个位置，导致Item被遮挡。下面给你两种可靠的解决方案：

方案一：手动计算滚动偏移量（推荐） #

核心思路是：计算出目标Item的位置，然后让它滚动到Header的下方，而不是CollectionView的绝对顶部。具体步骤如下：

1. 获取目标Item的布局属性和Frame
2. 获取当前Section的Header高度（要考虑FlowLayout的配置或者Delegate的自定义高度）
3. 计算正确的滚动偏移量，确保Item顶部在Header下方
4. 使用setContentOffset执行滚动

代码示例：

let indexPath = IndexPath(section: 0, row: 2)

// 1. 获取目标Item的Frame（基于CollectionView的content坐标系）
guard let itemAttrs = collectionView.layoutAttributesForItem(at: indexPath) else {
    return
}
let itemFrame = itemAttrs.frame

// 2. 获取当前Section的Header高度
var headerHeight: CGFloat = 0
if let flowLayout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout {
    // 适配FlowLayout默认配置的Header高度
    headerHeight = flowLayout.headerReferenceSize.height
} else if let delegate = collectionView.delegate as? UICollectionViewDelegateFlowLayout {
    // 适配Delegate自定义的Header高度
    headerHeight = delegate.collectionView?(collectionView, layout: collectionView.collectionViewLayout, referenceSizeForHeaderInSection: indexPath.section).height ?? 0
}

// 3. 计算目标偏移量：Item顶部Y减去Header高度，同时避免滚动到负数区域
let targetOffsetY = max(itemFrame.minY - headerHeight, 0)
// 考虑CollectionView的contentInset.top（如果有设置的话）
let finalOffset = CGPoint(x: 0, y: targetOffsetY - collectionView.contentInset.top)

// 4. 执行滚动
collectionView.setContentOffset(finalOffset, animated: true)

方案二：利用ContentInset调整滚动边界 #

如果你希望所有滚动到.top的操作都自动避开Header，可以给CollectionView设置额外的contentInset，让滚动的顶部边界从Header下方开始：

// 在初始化CollectionView或viewDidLoad中配置
if let flowLayout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout {
    let headerHeight = flowLayout.headerReferenceSize.height
    collectionView.contentInset = UIEdgeInsets(top: headerHeight, left: 0, bottom: 0, right: 0)
    collectionView.scrollIndicatorInsets = collectionView.contentInset
}

不过这个方案有个小缺点：它会让整个CollectionView的内容向下偏移Header高度的距离，如果你不希望内容整体下移，还是方案一更合适。

为什么原代码会失效？ #

scrollToItem(at: .top)的逻辑是将Item的顶部对齐到CollectionView的content区域顶部，而当sectionHeadersPinToVisibleBounds = true时，Header会固定在CollectionView的可视区域顶部（覆盖在content区域上方），所以Item的顶部就会被Header挡住。我们的解决方案本质上就是修正了滚动的目标位置，让Item避开Header的覆盖区域。

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