UICollectionView横向列表调用scrollToItem无法居中单元格问题

我之前也踩过这个坑！问题出在scrollToItem(at:at:animated:)的对齐逻辑上——当你给CollectionView设置了左右contentInset后，系统默认的.centeredHorizontally对齐是基于CollectionView的可视bounds（扣除contentInset后的区域）计算的，这就导致左半部分的Item没法正确滚动到屏幕中心。

下面给你两个靠谱的解决方案，按需选择：

方案一：手动计算偏移量，精准控制滚动位置 #

如果不想改动原有布局，手动计算目标偏移量是最直接的办法。核心是先拿到目标Item的位置，再计算让它和屏幕中心对齐的contentOffset，别忘了把contentInset的影响算进去。

代码示例：

func scrollToItemCentered(at indexPath: IndexPath, animated: Bool) {
    // 获取目标Item的布局属性
    guard let itemAttributes = collectionView.layoutAttributesForItem(at: indexPath) else {
        return
    }
    
    // Item中心在Content区域的X坐标
    let itemCenterX = itemAttributes.center.x
    // 屏幕中心相对于CollectionView可视区域的X坐标
    let screenCenterX = collectionView.bounds.midX
    // 计算目标偏移量：抵消contentInset的偏移影响，让Item中心对齐屏幕中心
    let targetOffsetX = itemCenterX - screenCenterX + collectionView.contentInset.left
    
    // 设置最终滚动位置
    let targetOffset = CGPoint(x: targetOffsetX, y: collectionView.contentOffset.y)
    collectionView.setContentOffset(targetOffset, animated: animated)
}

以后用这个方法代替系统的scrollToItem，不管是左半还是右半部分的Item，都能精准滚动到屏幕中心。

方案二：自定义FlowLayout，让布局自动处理居中 #

如果希望手动滚动和调用scrollToItem都能自动居中，自定义FlowLayout是更优雅的选择。重写布局的targetContentOffset方法，让布局自己计算正确的偏移量，同时兼容contentInset。

自定义布局代码：

class CenteredCollectionViewFlowLayout: UICollectionViewFlowLayout {
    override func targetContentOffset(forProposedContentOffset proposedContentOffset: CGPoint, withScrollingVelocity velocity: CGPoint) -> CGPoint {
        guard let collectionView = collectionView else {
            return super.targetContentOffset(forProposedContentOffset: proposedContentOffset, withScrollingVelocity: velocity)
        }
        
        // 构建当前可视区域的范围
        let targetRect = CGRect(x: proposedContentOffset.x, y: 0, width: collectionView.bounds.width, height: collectionView.bounds.height)
        // 找到可视区域内最接近屏幕中心的Item
        guard let closestItemAttrs = layoutAttributesForElements(in: targetRect)?.sorted(by: {
            abs($0.center.x - (proposedContentOffset.x + collectionView.bounds.midX)) < abs($1.center.x - (proposedContentOffset.x + collectionView.bounds.midX))
        }).first else {
            return super.targetContentOffset(forProposedContentOffset: proposedContentOffset, withScrollingVelocity: velocity)
        }
        
        // 计算带contentInset补偿的目标偏移量
        let targetOffsetX = closestItemAttrs.center.x - collectionView.bounds.midX + collectionView.contentInset.left
        return CGPoint(x: targetOffsetX, y: proposedContentOffset.y)
    }
}

使用时，把CollectionView的布局替换成这个自定义的CenteredCollectionViewFlowLayout，之后直接调用系统方法即可：

collectionView.scrollToItem(at: indexPath, at: .centeredHorizontally, animated: true)

这样不管是主动调用滚动，还是用户手动滑动结束，Item都会自动对齐到屏幕中心，体验更流畅。

注意事项 #

• 确保tileSize是Item的实际大小，没有被minimumInteritemSpacing等布局属性干扰，否则计算会有偏差。
• 你已经设置scrollIndicatorInsets和contentInset保持一致，这一点做得很对，无需改动。

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