TableView复选框位置错误、选中关联异常及滚动消失问题求助

嘿，这个问题我太熟了——典型的UITableViewCell复用坑！咱们一步步来拆解解决：

问题根源 #

你遇到的两个问题本质都是同一个原因：UITableView的Cell复用机制，加上没有正确持久化每行的选中状态：

• 跨组行选中状态联动：复用的Cell会带着之前的选中状态，当新行复用这个Cell时，如果没重置就直接显示，就会出现看起来其他行被选中的情况。
• 滚动后状态消失：选中状态只存在于Cell对象里，而Cell被滚出屏幕后会被回收复用，之前的状态也就随之丢失了。

解决方案：用数据模型持久化选中状态 #

核心思路是：把每一行的选中状态绑定到对应的数据模型上，而不是依赖Cell本身。每次复用Cell时，从数据模型里读取状态并设置；点击时更新数据模型的状态，再同步UI。

步骤1：给数据模型添加选中状态属性 #

假设你的分组数据是二维数组，每个元素对应一行的数据，给模型新增一个isSelected布尔属性来保存选中状态：

// 示例数据模型
struct RowItem {
    let title: String
    var isSelected: Bool = false // 新增选中状态属性
}

// 你的分组数据结构示例
var sectionData: [[RowItem]] = [
    [RowItem(title: "组0行0"), RowItem(title: "组0行1")],
    [RowItem(title: "组1行0")],
    [RowItem(title: "组2行0")],
    [RowItem(title: "组3行0")]
]

步骤2：在Cell复用时正确设置复选框状态 #

在tableView(_:cellForRowAt:)方法里，不管Cell是不是复用的，都要严格根据当前行的数据模型来设置复选框状态，彻底摆脱对Cell旧状态的依赖：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "YourCellID", for: indexPath) as! YourCustomCell
    
    // 1. 获取当前行对应的数据模型
    let item = sectionData[indexPath.section][indexPath.row]
    
    // 2. 严格根据模型设置复选框状态
    cell.checkboxButton.isSelected = item.isSelected
    
    // 3. 设置其他UI内容（比如标题）
    cell.titleLabel.text = item.title
    
    return cell
}

步骤3：处理点击事件，更新数据模型 #

不管是点击Cell本身还是点击复选框按钮，核心都是更新对应数据模型的isSelected属性，再刷新当前行UI：

方式1：点击Cell触发状态切换

func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    // 1. 切换对应数据模型的选中状态
    sectionData[indexPath.section][indexPath.row].isSelected.toggle()
    
    // 2. 只刷新当前行（避免全量刷新影响性能）
    tableView.reloadRows(at: [indexPath], with: .automatic)
    
    // 取消Cell的选中高亮（可选）
    tableView.deselectRow(at: indexPath, animated: true)
}

方式2：点击自定义Cell内的复选框按钮触发

如果是直接点击复选框按钮，需要给按钮绑定点击事件并传递当前行的indexPath：

// 自定义Cell代码
class YourCustomCell: UITableViewCell {
    @IBOutlet weak var checkboxButton: UIButton!
    @IBOutlet weak var titleLabel: UILabel!
    
    var indexPath: IndexPath?
    var onCheckboxTap: ((IndexPath) -> Void)?
    
    @IBAction func checkboxTapped(_ sender: UIButton) {
        guard let indexPath = indexPath else { return }
        onCheckboxTap?(indexPath)
    }
}

// 在tableView(_:cellForRowAt:)里绑定回调
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "YourCellID", for: indexPath) as! YourCustomCell
    
    let item = sectionData[indexPath.section][indexPath.row]
    cell.checkboxButton.isSelected = item.isSelected
    cell.titleLabel.text = item.title
    
    // 绑定indexPath和点击回调
    cell.indexPath = indexPath
    cell.onCheckboxTap = { [weak self] indexPath in
        self?.sectionData[indexPath.section][indexPath.row].isSelected.toggle()
        tableView.reloadRows(at: [indexPath], with: .automatic)
    }
    
    return cell
}

关键注意点 #

• 永远不要把状态存在Cell里：Cell是会被复用的临时对象，只有数据模型是和每一行永久绑定的。
• 避免全量刷新：用reloadRows(at:with:)只刷新变化的行，比reloadData()性能更优。
• 重置Cell状态：如果你的Cell还有其他可变UI元素，复用的时候也要记得重置，避免残留旧数据。

这样处理后，不管怎么滚动或者点击，选中状态都会准确对应每一行，不会再出现联动或丢失的问题啦！

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