UICollectionView Cell复用引发状态错乱，求助解决方案

DevOps 小满

2026-5-13

解决UICollectionView Cell复用导致按钮状态混乱的问题

兄弟，我太懂你这种被UICollectionView复用机制搞到头疼的感觉了！你的问题核心在于错误地试图通过保存Cell实例来维护状态，但Cell是复用池管理的，同一个Cell会被用来展示不同的数据项，这就导致状态混乱。而且你在cellForItemAt里的逻辑又会覆盖Cell的状态，prepareForReuse自然起不到预期效果。

问题根源分析

你现在把Cell存在addressCells数组里，但数组里的Cell实例随时可能被复用去展示其他地址。当滚动时，cellForItemAt会重新配置Cell，这时候你之前存在数组里的Cell状态已经失效了——因为它可能已经被用来展示另一个地址了。

正确的解决方案：让数据源承载状态

UICollectionView的设计原则是数据源是唯一可信的状态来源，我们应该把“地址是否被确认”的状态存在Address模型里，而不是Cell中。每次配置Cell时，从数据源读取最新状态来渲染UI，这样不管Cell怎么复用，都能展示正确的内容。

步骤1：修改Address模型，添加状态属性

给你的Address类新增一个isConfirmed属性，用来记录该地址是否被确认：

class Address {
    // 保留你原有的其他属性（比如shopAddressDetail等）
    var isConfirmed: Bool = false // 新增状态标记
}

步骤2：重构cellForItemAt方法，基于数据源配置Cell

删除保存Cell到数组的逻辑，改为直接从数据源读取状态来配置按钮：

override func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell { 
    let cell = collectionView.dequeueReusableCell(withReuseIdentifier: reuseIdentifier, for: indexPath) as! AddressCollectionViewCell 
    let currentAddress = addresses[indexPath.row]
    
    // 基础配置
    cell.addressObj = currentAddress 
    cell.configureCellForAddress(currentAddress) 
    cell.cellTag = indexPath.row 
    cell.cellDelegate = self 

    // 根据数据源状态配置按钮
    if currentAddress.isConfirmed {
        cell.confirmAddress.setTitle("CONFIRMED", for: .normal) 
        cell.confirmAddress.isEnabled = false 
        cell.confirmAddress.backgroundColor = UIColor(red: 0, green: 100/255, blue: 0, alpha: 1) 
    } else {
        // 这里可以依赖prepareForReuse重置，也可以显式设置，更保险
        cell.confirmAddress.setTitle("Confirm Address", for: .normal) 
        cell.confirmAddress.isEnabled = true 
        cell.confirmAddress.backgroundColor = APP_UNIVERSAL_COLOR 
    }

    return cell 
}

步骤3：修改按钮点击逻辑，更新数据源并刷新Cell

点击按钮时，不要修改Cell的状态，而是更新数据源中对应Address的isConfirmed属性，然后刷新对应的Cell：

extension AddressesCollectionViewController: AddressCollectionViewCellDelegate { 
    func confirmBtnPressed(confirmAddressObj: Address, cell: AddressCollectionViewCell) { 
        // 找到该地址在数据源中的索引
        guard let targetIndex = addresses.firstIndex(where: { $0 === confirmAddressObj }) else { return }
        
        // 更新数据源状态
        addresses[targetIndex].isConfirmed = true
        
        // 只刷新对应的Cell，避免全局刷新影响性能
        collectionView.reloadItems(at: [IndexPath(row: targetIndex, section: 0)])
        
        // 如果需要通知外部代理，在这里调用
        addressCollectionViewDelegate?.configureCellsAccordingToChanges(cell: cell)
    }
}

步骤4：确保prepareForReuse正确重置状态

你的prepareForReuse方法没问题，但建议加上重置Cell内部状态的代码，避免复用残留：

override func prepareForReuse() { 
    super.prepareForReuse() 
    cellTag = 0 
    isAddressConfirmed = false // 重置Cell内部的状态标记
    confirmAddress.setTitle("Confirm Address", for: .normal) 
    confirmAddress.backgroundColor = APP_UNIVERSAL_COLOR 
    confirmAddress.isEnabled = true 
}

为什么这样能解决问题？

UICollectionView的Cell复用机制意味着，同一个Cell实例会被反复用来展示不同的数据项。如果把状态存在Cell里，当Cell被复用时，旧的状态会被带到新的数据项上。而把状态存在数据源模型里，每次配置Cell时都从数据源读取最新状态，就能保证每个Cell展示的都是对应数据项的正确状态。

内容的提问来源于stack exchange，提问作者Mohsin Khubaib Ahmed