UICollectionView长滚动后选中状态不显示问题求助

这问题我之前做项目时也踩过坑！大概率是UICollectionView的复用机制加上滚动结束时的渲染优先级问题在搞鬼，给你几个针对性的排查和解决方向：

• 确保选中状态的数据源独立可靠
  不要依赖cell自身的isSelected状态来记录选中位置（因为cell会被复用），一定要单独维护一个变量（比如var selectedIndexPath: IndexPath?）来存储选中的索引路径。
  在cellForItemAt方法里，必须根据这个变量来配置cell的选中状态，示例代码：

  func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
      let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "YourCustomCellID", for: indexPath) as! YourCustomCell
      // 核心：根据数据源设置选中状态，而不是依赖cell自身
      cell.isSelected = (selectedIndexPath == indexPath)
      // 其他自定义单元格渲染逻辑
      return cell
  }
  

  同时在didSelectItemAt里更新数据源并刷新对应cell：

  func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
      let previousSelected = selectedIndexPath
      selectedIndexPath = indexPath
      // 只刷新必要的cell，避免全量刷新影响性能
      var reloadPaths = [indexPath]
      if let prevPath = previousSelected {
          reloadPaths.append(prevPath)
      }
      collectionView.reloadItems(at: reloadPaths)
  }
  

• 监听滚动结束事件，强制刷新选中cell
  你遇到的“滚动停止时不显示，轻微滚动就正常”的现象，大概率是滚动结束时UICollectionView的布局更新没有触发cell的重新配置。可以监听滚动停止的两个代理方法，手动刷新选中的cell：

  func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
      refreshSelectedCellIfNeeded()
  }
  
  func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
      if !decelerate {
          refreshSelectedCellIfNeeded()
      }
  }
  
  private func refreshSelectedCellIfNeeded() {
      guard let selectedPath = selectedIndexPath else { return }
      // 强制刷新选中的cell，确保状态正确渲染
      collectionView.reloadItems(at: [selectedPath])
  }
  

• 检查自定义cell的选中状态逻辑
  如果你的自定义cell重写了isSelected的setter方法，要确保UI更新是在主线程执行，且没有被延迟操作覆盖：

  override var isSelected: Bool {
      didSet {
          DispatchQueue.main.async {
              // 这里写选中状态的UI变更逻辑，比如背景色、边框等
              self.backgroundColor = self.isSelected ? .systemBlue : .systemBackground
              self.layer.borderColor = self.isSelected ? UIColor.systemBlue.cgColor : UIColor.clear.cgColor
          }
      }
  }
  

  有时候异步UI更新会在滚动结束时还未完成，轻微滚动触发cell复用/布局更新后才会执行，这就导致了现象差异。

• 排除布局缓存干扰（备选方案）
  如果前面的方法都没解决，可以尝试在滚动结束时强制刷新布局（注意：可能影响性能，谨慎使用）：

  private func refreshSelectedCellIfNeeded() {
      guard let selectedPath = selectedIndexPath else { return }
      collectionView.collectionViewLayout.invalidateLayout()
      collectionView.reloadItems(at: [selectedPath])
  }
  

核心思路就是：让选中状态完全由数据源驱动，而非cell自身状态，同时确保在滚动结束这个特殊时机，主动触发cell的重新配置，避免渲染滞后。

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