可复用单元格的数据持久化问题：复选框状态无法正确保留

嘿，这个坑我踩过好多次了——UITableView的单元格复用机制虽然高效，但如果没把UI状态和数据源牢牢绑定，分分钟就会出现状态错乱、用户操作不持久的问题。核心原因很简单：你之前只在tableView:cellForRowAt里给复选框设置了初始状态，但用户修改后的状态没同步到数据源模型，滚动时复用旧单元格，自然就会加载错误的状态。

下面给你一套完整的解决方案，从数据模型到单元格配置都理清楚：

第一步：构建可靠的数据源模型 #

首先，你需要一个能持久化每个复选框状态的数据模型，把所有UI状态都存在模型里，而不是依赖单元格的控件。

如果是单行单个复选框，模型可以是这样：

// 单个隐私偏好选项的模型
struct PrivacyOption {
    let title: String
    var isSelected: Bool // 关键！用这个变量保存选中状态
}

// 整个表格的数据源，每个元素对应一行
var customerPrivacyOptions: [PrivacyOption] = []

如果是一行有多个可变数量的复选框，模型要对应嵌套：

// 每行的模型，包含多个选项
struct PrivacyPreferenceRow {
    let rowTitle: String
    var options: [PrivacyOption] // 该行所有复选框的状态
}

var preferenceRows: [PrivacyPreferenceRow] = []

第二步：让数据源成为UI的唯一真相来源 #

在tableView:cellForRowAt里，不管单元格是第一次加载还是复用，都完全根据数据源模型来设置复选框状态，同时给复选框绑定点击回调，用户操作时立刻更新数据源。

单个复选框的单元格示例 #

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "SingleOptionCell", for: indexPath) as! SingleOptionCell
    
    // 先清空旧的回调，避免复用时触发错误逻辑
    cell.onCheckboxTap = nil
    
    let option = customerPrivacyOptions[indexPath.row]
    // 严格根据模型设置UI状态
    cell.checkboxButton.isSelected = option.isSelected
    cell.titleLabel.text = option.title
    
    // 绑定点击事件，更新数据源
    cell.onCheckboxTap = { [weak self] in
        guard let self = self else { return }
        // 切换对应位置模型的选中状态
        self.customerPrivacyOptions[indexPath.row].isSelected.toggle()
        // 可选：如果需要实时同步到服务器，在这里发起请求
    }
    
    return cell
}

多个复选框的单元格示例 #

如果是一行多个复选框，自定义单元格里要动态生成控件，并且每个控件的点击都对应更新数据源的对应位置：

// 自定义多行复选框单元格
class MultiOptionCell: UITableViewCell {
    @IBOutlet weak var rowTitleLabel: UILabel!
    @IBOutlet weak var optionsStackView: UIStackView!
    
    var onOptionTap: ((Int, Int) -> Void)? // 回调参数：行索引、选项索引
    private var currentRowIndex: Int = 0
    
    override func prepareForReuse() {
        super.prepareForReuse()
        // 复用前清空旧控件和状态
        for subview in optionsStackView.arrangedSubviews {
            subview.removeFromSuperview()
        }
        rowTitleLabel.text = nil
        onOptionTap = nil
    }
    
    // 配置单元格数据
    func configure(with row: PrivacyPreferenceRow, rowIndex: Int) {
        currentRowIndex = rowIndex
        rowTitleLabel.text = row.rowTitle
        
        // 动态生成每个复选框
        for (optionIndex, option) in row.options.enumerated() {
            let checkbox = UIButton(type: .checkbox)
            checkbox.setTitle(option.title, for: .normal)
            checkbox.isSelected = option.isSelected
            checkbox.tag = optionIndex // 用tag标记选项索引
            checkbox.addTarget(self, action: #selector(optionTapped(_:)), for: .touchUpInside)
            optionsStackView.addArrangedSubview(checkbox)
        }
    }
    
    @objc private func optionTapped(_ sender: UIButton) {
        let optionIndex = sender.tag
        // 通知外部更新数据源
        onOptionTap?(currentRowIndex, optionIndex)
    }
}

然后在cellForRowAt里调用配置方法：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "MultiOptionCell", for: indexPath) as! MultiOptionCell
    
    let row = preferenceRows[indexPath.row]
    cell.configure(with: row, rowIndex: indexPath.row)
    
    cell.onOptionTap = { [weak self] rowIndex, optionIndex in
        guard let self = self else { return }
        // 更新对应行对应选项的状态
        self.preferenceRows[rowIndex].options[optionIndex].isSelected.toggle()
        // 可选：同步到服务器
    }
    
    return cell
}

第三步：做好单元格复用的状态重置 #

一定要在自定义单元格的prepareForReuse()方法里清空旧的UI状态和回调，避免复用残留的旧数据。上面的示例里已经包含了这一步，这是防止状态错乱的关键细节。

关键注意事项 #

• 绝对不要用单元格控件保存状态：所有选中状态必须存在数据源模型里，UI只是模型的“镜像”，永远让数据驱动UI，而不是反过来。
• 避免在单元格内部直接修改状态：单元格只负责展示数据和传递用户操作，状态更新交给数据源处理，这样不管怎么滚动，UI都会和数据保持一致。
• 如果需要立刻刷新UI：当数据源更新后，可调用tableView.reloadRows(at: [indexPath], with: .none)，不过只要数据源正确，下次单元格复用时会自动加载最新状态。

这样处理后，不管怎么滚动表格，复选框的状态都会和数据源保持一致，用户的修改也会持久化，再也不会出现状态错乱的问题了。

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