UICollectionView关闭多选属性后仍选中多个单元格问题求助

问题根源 #

这个问题是UICollectionView cell复用机制和手动管理选中状态逻辑冲突导致的，具体原因有3个：

• cell复用没有重置状态：之前被标记为选中的cell滚动出屏幕后会被复用，没有主动清除选中样式的话，新显示的cell会继承旧的选中状态，看起来就像多个cell同时被选中
• 手动切换选中状态脱离系统管理：你自定义的toggleSelect()方法仅修改了cell的样式，没有和UICollectionView自带的选中状态同步，也没有主动取消之前选中cell的状态
• 选中状态更新后没有刷新对应cell：切换新主题后仅修改了当前点击cell的样式，没有刷新之前选中的cell清除它的选中样式

解决方案 #

第一步：绑定cell选中状态到系统属性 #

在ThemesCollectionViewCell中重写isSelected属性，把你之前toggleSelect()里的样式切换逻辑移到属性观察者里，让系统选中状态变化时自动更新样式：

override var isSelected: Bool {
    didSet {
        // 替换成你自己的选中/未选中样式逻辑
        if isSelected {
            layer.borderWidth = 2
            layer.borderColor = UIColor.systemBlue.cgColor
        } else {
            layer.borderWidth = 0
            layer.borderColor = UIColor.clear.cgColor
        }
    }
}

第二步：优化cell复用逻辑，明确设置选中状态 #

修改cellForItemAt方法，先重置cell状态，再根据全局选中的主题明确设置选中状态，避免用toggle导致状态混乱：

func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
    guard let cell = collectionView.dequeueReusableCell(withReuseIdentifier: ThemesCollectionViewCell.reuseID, for: indexPath) as? ThemesCollectionViewCell else {
        fatalError("Unexpected cell class dequeued")
    }
    
    cell.currentIndexPath = indexPath
    // 先重置cell选中状态，清除复用遗留的样式
    cell.isSelected = false
    
    // 明确设置当前cell是否为选中状态
    if ThemeManager.current.themeName == themeManager.themeNames[indexPath.row].themeName {
        cell.isSelected = true
        // 同步collectionView的选中记录
        collectionView.selectItem(at: indexPath, animated: false, scrollPosition: [])
    }
    
    // 原有图片加载逻辑保持不变
    themeManager.fetchImage(atIndex: indexPath.item) { [weak cell] image, itemIndex in
        guard let cell = cell, let image = image else { return }
        DispatchQueue.main.async {
            guard let cellIndexPath = cell.currentIndexPath, cellIndexPath.item == itemIndex else {
                return
            }
            cell.themeCellImageView.image = image
        }
    }
    
    return cell
}

第三步：修改选中逻辑，同步更新旧的选中状态 #

修改didSelectItemAt方法，切换选中后主动取消之前的选中项，刷新对应cell：

func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
    if indexPath.row > 1 {
        // 找到之前选中的indexPath，取消选中并刷新
        if let preSelectedIndex = themeManager.themeNames.firstIndex(where: { $0.themeName == ThemeManager.current.themeName }),
           preSelectedIndex != indexPath.row {
            collectionView.deselectItem(at: IndexPath(item: preSelectedIndex, section: 0), animated: false)
            collectionView.reloadItems(at: [IndexPath(item: preSelectedIndex, section: 0)])
        }
        
        // 保存新选中的主题
        if let cell = collectionView.cellForItem(at: indexPath) as? ThemesCollectionViewCell {
            cell.saveData(value: indexPath.row)
        }
        // 刷新当前cell更新选中样式
        collectionView.reloadItems(at: [indexPath])
    } else {
        if indexPath.row == 0 {
            performSegue(withIdentifier: "toCreateTheme", sender: nil)
            // 创建主题cell不需要保持选中，主动取消
            collectionView.deselectItem(at: indexPath, animated: false)
        } else {
            // 随机主题逻辑
            let randomIndex = Int.random(in: 2...41)
            // 先取消之前选中的cell
            if let preSelectedIndex = themeManager.themeNames.firstIndex(where: { $0.themeName == ThemeManager.current.themeName }) {
                collectionView.deselectItem(at: IndexPath(item: preSelectedIndex, section: 0), animated: false)
                collectionView.reloadItems(at: [IndexPath(item: preSelectedIndex, section: 0)])
            }
            // 保存随机选中的主题
            if let cell = collectionView.cellForItem(at: indexPath) as? ThemesCollectionViewCell {
                cell.saveData(value: randomIndex)
            }
            // 取消当前随机入口cell的选中，刷新随机到的cell的选中状态
            collectionView.deselectItem(at: indexPath, animated: false)
            collectionView.reloadItems(at: [IndexPath(item: randomIndex, section: 0)])
        }
    }
}

第四步：删除冗余代码 #

删除didDeselectItemAt方法里手动调用toggleSelect()的逻辑，现在选中样式已经交给isSelected自动处理，不需要手动干预。

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