滚动TableView后复用单元格按钮选中状态丢失的解决方法

嘿，这个TableView单元格复用的坑我简直太熟悉了！你已经能成功捕获按钮的选中值，说明核心逻辑已经走通了，现在卡壳在UI状态和数据的绑定上——毕竟复用机制会让单元格的临时UI状态被覆盖，解决的核心思路就是让数据来驱动UI，而不是依赖单元格本身的状态。下面给你几个最优的解决方法，按推荐程度排序：

1. 核心方案：用数据源维护每个单元格的按钮选中状态 #

这是最标准、最可靠的解决方案，完全贴合TableView的设计思想：

• 首先定义一个数据模型，把每个单元格需要展示的内容（包括按钮选中状态）都存进去。比如：

  struct CellDataModel {
      let labelContent: String
      var buttonSelectionStates: [Bool] // 数组长度对应5个按钮，true表示选中
  }
  

• 你的TableView数据源数组就用这个模型类型，比如var tableViewData: [CellDataModel] = []，初始化的时候给每个模型的buttonSelectionStates设置默认值（比如全false）。
• 在cellForRowAt方法里，给单元格配置数据时，严格按照模型里的状态设置按钮的UI：

  func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
      let cell = tableView.dequeueReusableCell(withIdentifier: "YourCustomCellID", for: indexPath) as! YourCustomCell
      let currentModel = tableViewData[indexPath.row]
      
      // 设置标签文本
      cell.cellLabel.text = currentModel.labelContent
      
      // 遍历栈视图里的按钮，根据模型状态设置选中样式
      for (buttonIndex, subview) in cell.buttonStackView.arrangedSubviews.enumerated() {
          guard let button = subview as? UIButton else { continue }
          button.isSelected = currentModel.buttonSelectionStates[buttonIndex]
          // 这里可以自定义选中/未选中的样式，比如背景色、文字颜色
          button.backgroundColor = button.isSelected ? .systemBlue : .lightGray
          button.setTitleColor(button.isSelected ? .white : .black, for: .normal)
      }
      
      // 给单元格绑定按钮点击回调，用来更新数据源
      cell.onButtonTapped = { [weak self] tappedIndex in
          guard let self = self else { return }
          // 切换对应按钮的选中状态
          self.tableViewData[indexPath.row].buttonSelectionStates[tappedIndex].toggle()
          // 可选：如果需要立即刷新当前单元格的UI，调用下面的方法（不调用也没关系，滚动回来会自动重新配置）
          // tableView.reloadRows(at: [indexPath], with: .none)
      }
      
      return cell
  }
  

• 自定义单元格里用闭包传递按钮点击事件，避免直接操作数据源，实现解耦：

  class YourCustomCell: UITableViewCell {
      @IBOutlet weak var cellLabel: UILabel!
      @IBOutlet weak var buttonStackView: UIStackView!
      
      // 定义闭包，用来传递按钮点击的索引
      var onButtonTapped: ((Int) -> Void)?
      
      override func awakeFromNib() {
          super.awakeFromNib()
          // 给每个按钮添加点击事件
          for (index, subview) in buttonStackView.arrangedSubviews.enumerated() {
              guard let button = subview as? UIButton else { continue }
              button.tag = index // 用tag标记按钮索引
              button.addTarget(self, action: #selector(handleButtonTap(_:)), for: .touchUpInside)
          }
      }
      
      @objc private func handleButtonTap(_ sender: UIButton) {
          // 触发闭包，传递点击的按钮索引
          onButtonTapped?(sender.tag)
      }
      
      override func prepareForReuse() {
          super.prepareForReuse()
          // 清空闭包，避免引用旧的indexPath导致错误
          onButtonTapped = nil
          // 可以重置一些非数据驱动的临时状态，比如按钮高亮
          for subview in buttonStackView.arrangedSubviews {
              guard let button = subview as? UIButton else { continue }
              button.isHighlighted = false
          }
      }
  }
  

2. 进阶优化：避免重复绑定点击事件 #

如果你的单元格是代码创建而非xib/storyboard，要注意在prepareForReuse里先移除旧的点击事件，再重新绑定，避免重复触发：

// 在cellForRowAt的按钮配置环节
for (buttonIndex, subview) in cell.buttonStackView.arrangedSubviews.enumerated() {
    guard let button = subview as? UIButton else { continue }
    // 先移除所有旧的事件
    button.removeTarget(nil, action: nil, for: .allEvents)
    // 重新绑定点击事件
    button.addTarget(self, action: #selector(globalButtonTapHandler(_:)), for: .touchUpInside)
    button.tag = indexPath.row * 10 + buttonIndex // 用组合tag区分行和按钮索引，避免同索引冲突
}

然后在全局的点击处理方法里解析tag，找到对应的行和按钮索引，更新数据源。

关键注意事项 #

• 绝对不要把按钮的选中状态存在单元格实例里，因为单元格会被复用，状态会被其他行覆盖。
• prepareForReuse方法只用来清理临时状态，不要在这里重置选中状态——因为cellForRowAt会重新从数据源读取状态并设置。
• 如果需要支持多按钮选中（比如允许多选），模型里用[Bool]数组；如果是单选，用Int?存储选中的按钮索引即可，逻辑更简洁。

这个方案是TableView复用场景下的标准最优解，既符合MVC的设计原则，又能彻底解决状态丢失的问题，后续维护也很方便。

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