如何获取UICollectionView首个Cell？遇返回nil及可见Cell异常问题

问题根源分析 #

• cellForItem返回nil：cellForItem(at:)仅能获取当前在屏幕可见范围内、且已被collectionView渲染完成的cell。从日志里的cell frame坐标（如(58950 0; 393 128)）来看，你的collectionView的contentOffset异常偏大，导致indexPath(0,0)对应的cell实际不在屏幕可见区域内，自然返回nil。
• visibleCells数量异常：日志中出现多个不同内存地址的TestCell实例，且重复出现相同的frame坐标，结合models.count=3但visibleCells有6个不同实例，大概率是你使用了无限轮播类的自定义布局（比如通过复制数据源、循环滚动实现伪无限），collectionView为实现滚动效果提前创建了额外的cell实例，或者布局逻辑中重复添加了cell。

解决方案 #

1. 修复cellForItem返回nil的问题

直接通过cellForItem(at:)获取cell修改UI的方式不可靠（依赖cell可见性），正确做法是通过数据源标记状态，再刷新cell：

• 给数据源model添加标记属性，比如：

struct YourModel {
    // 其他属性
    var isHighlighted: Bool = false
}

• 收到通知时修改数据源标记并刷新对应cell：

@objc func getNotification() {
    guard models.count > 0 else { return }
    models[0].isHighlighted = true
    // 仅刷新目标cell，避免全局刷新
    collectionView.reloadItems(at: [IndexPath(row: 0, section: 0)])
}

• 在cellForItemAt中根据标记设置样式：

func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
    let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "TestCell", for: indexPath) as! TestCell
    let model = models[indexPath.row]
    cell.backgroundColor = model.isHighlighted ? .systemRed : .systemBackground
    // 其他cell配置逻辑
    return cell
}

如果一定要直接操作可见cell（不推荐，cell重用后状态会丢失），可遍历visibleCells匹配逻辑上的目标cell：

@objc func getNotification() {
    for cell in collectionView.visibleCells {
        guard let testCell = cell as? TestCell,
              let indexPath = collectionView.indexPath(for: testCell),
              indexPath.row == 0 else { continue }
        testCell.changeBackgroundColor()
        break
    }
}

2. 修复visibleCells数量异常的问题

• 检查自定义布局（如UICollectionViewFlowLayout子类），是否存在重复创建cell、或复制数据源导致实际item数量远超models.count的情况，比如无限轮播中错误地将数据源重复多次。
• 确认numberOfItemsInSection方法返回值正确：

func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
    return models.count
}

• 若使用第三方轮播框架，检查配置是否开启过度预加载或冗余cell创建逻辑，将预加载数量调整为合理值（如屏幕可见数量+1）。

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