自定义UICollectionView加载时默认选中首项Cell失效问题排查

嘿，我之前也踩过一模一样的坑，咱们从几个常见的排查点入手解决：

1. 选中操作的时机不对 #

你在init(frame:)里直接尝试选中Cell大概率会失效——这时候CollectionView还没完成布局，Cell甚至还没被创建出来。

推荐把选中代码放到合适的生命周期方法里：

• 如果这个CollectionView是在UIViewController里，放到viewDidAppear(_:)中
• 如果是自定义View的一部分，放到layoutSubviews()（记得调用super）或者用DispatchQueue.main.async延迟执行，确保布局完成后再触发选中：

override init(frame: CGRect) {
    super.init(frame: frame)
    // 你的现有注册、约束代码...
    DispatchQueue.main.async {
        self.tabBarCollectionView.selectItem(at: IndexPath(item: 0, section: 0), animated: false, scrollPosition: [])
    }
}

2. 自定义Cell的选中状态UI没正确实现 #

选中状态的颜色不生效，很大可能是你的TabBarCell没有监听isSelected属性的变化。要在Cell里重写isSelected，触发UI更新：

class TabBarCell: UICollectionViewCell {
    // 你的Cell初始化、控件配置代码...
    
    override var isSelected: Bool {
        didSet {
            // 根据选中状态更新UI，比如背景色、文字颜色
            self.backgroundColor = isSelected ? .systemBlue : .systemGray5
            self.titleLabel.textColor = isSelected ? .white : .darkGray
        }
    }
    
    // 可选：如果Cell会被复用，记得在prepareForReuse里重置状态
    override func prepareForReuse() {
        super.prepareForReuse()
        self.isSelected = false
    }
}

3. 检查CollectionView的基础设置 #

别漏掉这两个容易忽略的细节：

• 确认tabBarCollectionView.allowsSelection = true（默认是true，但如果不小心被设为false就无法选中）
• 确认IndexPath的正确性：如果你的CollectionView有多section，要对应正确的section索引，比如第一个section是0的话，IndexPath(item: 0, section: 0)才是第一个Cell

4. 手动触发Cell的选中UI（备选方案） #

如果以上方法都不行，可以在CollectionView的cellForItemAt方法里，给第一个Cell主动设置选中状态：

func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
    let cell = collectionView.dequeueReusableCell(withReuseIdentifier: cellIdentifier, for: indexPath) as! TabBarCell
    // 配置Cell内容...
    if indexPath.item == 0 && indexPath.section == 0 {
        cell.isSelected = true
    }
    return cell
}

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