UICollectionView单个Cell控件异常：点击隐藏按钮滚动后位置错乱

嘿，这个问题我太熟了——本质就是UICollectionView的Cell复用机制在搞鬼！

你遇到的情况是因为：当Cell滚出屏幕后，会被系统放进复用池，等新的Cell需要显示时，系统会从池子里捞旧Cell重新使用。如果你只是在点击按钮时直接隐藏它，却没把这个“按钮需要隐藏”的状态存在数据源里，那么复用旧Cell的时候，它会带着之前的隐藏状态出现在新的indexPath位置上，就出现了按钮乱跳的情况。

下面是具体的解决方案，分三步走：

1. 给数据源模型添加状态属性 #

首先，你需要把“按钮是否隐藏”这个状态和你的数据模型绑定在一起。假设你的数据源是一个自定义模型数组，给模型加个isButtonHidden属性，默认值设为false（按钮默认显示）：

struct YourDataModel {
    // 你原来的其他属性，比如标题、图片地址等
    var itemTitle: String
    // 新增状态属性，记录按钮是否需要隐藏
    var isButtonHidden: Bool = false
}

2. 点击按钮时更新数据源状态 #

在Cell的按钮点击事件里，找到对应的indexPath，然后更新数据源中对应模型的状态，再刷新当前Cell（只刷新单个Cell比刷新整个CollectionView更高效）。这里用闭包来传递点击事件会比较简洁：

class YourCollectionViewCell: UICollectionViewCell {
    @IBOutlet weak var actionButton: UIButton!
    // 定义闭包，用来把点击事件传递给ViewController
    var onButtonTap: ((IndexPath) -> Void)?
    // 给Cell绑定当前的indexPath，方便点击时获取
    var currentIndexPath: IndexPath?

    @IBAction func buttonTapped(_ sender: UIButton) {
        guard let indexPath = currentIndexPath else { return }
        onButtonTap?(indexPath)
    }
}

然后在ViewController的cellForItemAt方法里，给Cell配置数据和闭包：

func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
    let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "YourCellID", for: indexPath) as! YourCollectionViewCell
    let model = yourDataSourceArray[indexPath.item]
    
    // 配置Cell的其他内容
    cell.titleLabel.text = model.itemTitle
    // 关键：根据数据源的状态设置按钮显示/隐藏
    cell.actionButton.isHidden = model.isButtonHidden
    
    // 绑定当前indexPath
    cell.currentIndexPath = indexPath
    // 设置按钮点击闭包
    cell.onButtonTap = { [weak self] tappedIndexPath in
        guard let self = self else { return }
        // 更新数据源的状态
        self.yourDataSourceArray[tappedIndexPath.item].isButtonHidden = true
        // 只刷新被点击的Cell
        self.collectionView.reloadItems(at: [tappedIndexPath])
    }
    
    return cell
}

3. 确保复用Cell时正确配置状态 #

这一步其实已经包含在上面的代码里了——每次Cell被复用（也就是进入cellForItemAt方法时），都会根据数据源里的isButtonHidden属性重新设置按钮的显示状态，而不是依赖Cell本身的旧状态。这样不管怎么滚动，每个Cell的按钮状态都会和数据源保持一致。

如果不想给Cell加currentIndexPath属性，也可以用collectionView.indexPath(for: cell)来获取当前Cell的indexPath，比如在按钮点击事件里：

@IBAction func buttonTapped(_ sender: UIButton) {
    guard let cell = sender.superview?.superview as? YourCollectionViewCell,
          let indexPath = collectionView.indexPath(for: cell) else { return }
    onButtonTap?(indexPath)
}

不过这种方式要注意视图层级的变化，还是给Cell绑定indexPath更稳妥。

核心思路就是：所有UI的显示状态都由数据源驱动，而不是直接操作UI后不管数据源，这样就能彻底解决复用导致的状态混乱问题。

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