如何实现UICollectionViewCell复用场景下的单选复选框功能？

这个问题在UICollectionView复用场景下非常典型——Cell的复用机制意味着你不能只在Cell内部维护选中状态，必须把选中状态的管理权交给外部（比如你的ViewController）来统一控制，这样才能保证同一时间只有一个Cell被选中。

下面是具体的修改方案：

第一步：重构Cell代码，让它只负责展示，把交互逻辑交给外部 #

首先修改你的SelectCollectionCell，去掉它自己维护的选中状态，改用闭包通知外部点击事件，同时通过外部传入的状态来更新按钮选中状态：

class SelectCollectionCell: UICollectionViewCell {
    @IBOutlet weak var teamName: UILabel!
    @IBOutlet weak var checkButton: UIButton!
    
    // 定义闭包，用来通知外部按钮的点击事件（参数：teamID，新的选中状态）
    var onCheckTapped: ((Int, Bool) -> Void)?
    
    override func awakeFromNib() {
        super.awakeFromNib()
        checkButton.setImage(#imageLiteral(resourceName: "checked"), for: .selected)
        // 初始化为未选中状态
        checkButton.isSelected = false
    }
    
    // 新增isSelected参数，由外部控制按钮选中状态
    func configureCell(_ teams: UserTeamModel, isSelected: Bool) {
        self.teamName.text = teams.name
        self.checkButton.tag = teams.id
        // 根据外部传入的状态设置按钮
        self.checkButton.isSelected = isSelected
    }
    
    @IBAction func checkButtonHandler(_ sender: UIButton) {
        // 计算点击后的新状态
        let newSelectedState = !sender.isSelected
        // 通知外部处理逻辑
        onCheckTapped?(sender.tag, newSelectedState)
    }
}

第二步：在ViewController中统一管理选中状态和单选逻辑 #

接下来修改你的SelectTeamView（假设这是包含CollectionView的ViewController），维护一个selectedTeamId变量来记录当前选中的团队ID，在Cell创建时传入选中状态，并处理Cell的点击回调：

class SelectTeamView: UIViewController, UICollectionViewDataSource, UICollectionViewDelegate {
    
    @IBOutlet weak var collectionView: UICollectionView!
    // 假设你的团队数据存在这里
    var teams: [UserTeamModel] = []
    // 记录当前选中的团队ID
    var selectedTeamId: Int?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        collectionView.dataSource = self
        collectionView.delegate = self
        // 这里可以加载你的teams数据
    }
    
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return teams.count
    }
    
    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "SelectCollectionCell", for: indexPath) as! SelectCollectionCell
        let currentTeam = teams[indexPath.item]
        
        // 配置Cell，传入当前团队是否被选中的状态
        cell.configureCell(currentTeam, isSelected: (currentTeam.id == selectedTeamId))
        
        // 设置Cell的点击回调，处理单选逻辑
        cell.onCheckTapped = { [weak self] tappedTeamId, shouldSelect in
            guard let self = self else { return }
            
            if shouldSelect {
                // 要选中当前团队：先记录之前选中的ID
                let previouslySelectedId = self.selectedTeamId
                // 更新当前选中ID
                self.selectedTeamId = tappedTeamId
                
                // 只刷新之前选中的Cell和当前Cell，避免全量刷新影响性能
                if let prevId = previouslySelectedId {
                    if let prevIndex = self.teams.firstIndex(where: { $0.id == prevId }) {
                        collectionView.reloadItems(at: [IndexPath(item: prevIndex, section: 0)])
                    }
                }
                collectionView.reloadItems(at: [indexPath])
            } else {
                // 要取消选中当前团队：清空选中ID并刷新当前Cell
                self.selectedTeamId = nil
                collectionView.reloadItems(at: [indexPath])
            }
        }
        
        return cell
    }
}

为什么这样改能解决问题？ #

1. 状态统一管理：选中状态由ViewController维护，而不是Cell自己存，避免了Cell复用导致的状态混乱——比如滚动时旧的Cell被复用到新位置，不会带着之前的选中状态。
2. 单选逻辑集中处理：所有的选中/取消操作都在ViewController里完成，能确保同一时间只有一个Cell被选中，不会出现多个Cell同时选中的情况。
3. 高效刷新：只刷新必要的Cell（之前选中的和当前操作的），比调用reloadData()性能更好，用户体验也更流畅。

一些注意事项 #

• 确保你在Storyboard/XIB里给Cell设置了正确的复用标识符（和代码里的"SelectCollectionCell"一致）。
• 闭包中使用[weak self]是为了避免循环引用，防止ViewController无法被正确释放。
• 如果你的团队数据有更新（比如新增、删除团队），记得重新刷新CollectionView，保证选中状态的正确性。

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