UITableView单元格重复显示问题求助

我用UITableView展示标签、按钮和图片，当表格行数超过30行时，按钮和图片出现显示错误，确定是单元格复用机制导致的。试过在tableView(_:cellForRowAt:)里先隐藏按钮和图片再根据条件显示，但没生效：

cell.cellBtn.isHidden = true
cell.cellImg.isHidden = true

let task = self.taskArray[indexPath.row]

if (task.done) {
    cell.cellBtn.isHidden = false
    cell.cellImg.isHidden = false
}

问题只出在用户选择后动态修改的按钮和图片上，以下是除复用问题外运行正常的基础代码：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {

    let cell = tableView.dequeueReusableCell(withIdentifier: "cell", for: indexPath) as! LessonsVCCell
    
    
    cell.cellTitle.text = lessonsArray[indexPath.row].name
    cell.cellDescription.text = lessonsArray[indexPath.row].details
    
    if lessonsArray[indexPath.row].blocked == 1 {
        
        cell.cellImg.isHidden = false
        cell.cellBtn.isHidden = false
        cell.cellImg.image = UIImage(systemName:"lock.fill")
        
        let cellImg = UIImageView(image: UIImage(named: "your_image_name"))
        cellImg.setImageColor(color: UIColor.systemOrange)
        
    } else {
        cell.cellBtn.isHidden = true
        cell.cellImg.image = UIImage(named:"RightAnswerNew")
    }
    
    return cell
}

自定义单元格代码：

@IBOutlet weak var cellTitle: UILabel!
@IBOutlet weak var cellBtn: CustomButton2!
@IBOutlet weak var cellImg: UIImageView!

var cellDelegate: LessonsProtocol?
var index: IndexPath = []    
var chapter:[Chapter]?

let context = (UIApplication.shared.delegate as! AppDelegate).persistentContainer.viewContext

override func setSelected(_ selected: Bool, animated: Bool) {
    super.setSelected(selected, animated: animated)

    // Configure the view for the selected state
}

@IBAction func buyBtnPressed(_ sender: Any) {
    
    cellDelegate?.onClickCell(index: (index.row))
    
    
    
    if CommonClass.lessonBonus > 0 {
        if (sender as AnyObject).currentTitle == "Get" {
            CommonClass.lessonBonus -= 1
            CommonClass.NbOfLessonsSelected += 1
            
            cellBtn.setTitle("\(CommonClass.NbOfLessonsSelected)", for: .normal)
            cellBtn.backgroundColor = .green
            
        }
        else { // lesson already selected
            CommonClass.lessonBonus += 1
            CommonClass.NbOfLessonsSelected -= 1
            cellBtn.setTitle("Get", for: .normal)
            cellBtn.backgroundColor = .clear
        }
    }
    
        // if confirmation not ok for user
        if CommonClass.removeOnlyAllowed == 1 && (sender as AnyObject).currentTitle != "Get" {
            CommonClass.lessonBonus += 1
            CommonClass.NbOfLessonsSelected -= 1
            cellBtn.setTitle("Get", for: .normal)
            cellBtn.backgroundColor = .clear
            CommonClass.removeOnlyAllowed = 0
        }
}

解决方法 #

1. 彻底重置单元格状态，避免复用残留 #

在cellForRowAt开头完全重置所有动态控件的默认状态，不能只设置部分属性，确保复用的单元格没有之前的状态残留：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "cell", for: indexPath) as! LessonsVCCell
    
    // 先重置所有可能被修改的控件状态
    cell.cellBtn.isHidden = true
    cell.cellBtn.setTitle("Get", for: .normal)
    cell.cellBtn.backgroundColor = .clear
    cell.cellImg.isHidden = true
    cell.cellImg.image = nil
    cell.cellImg.tintColor = .black // 重置 tintColor
    
    // 设置静态文本内容
    cell.cellTitle.text = lessonsArray[indexPath.row].name
    cell.cellDescription.text = lessonsArray[indexPath.row].details
    
    let lesson = lessonsArray[indexPath.row]
    if lesson.blocked == 1 {
        cell.cellImg.isHidden = false
        cell.cellBtn.isHidden = false
        cell.cellImg.image = UIImage(systemName:"lock.fill")
        cell.cellImg.tintColor = .systemOrange // 直接修改已有imageView的tintColor，不要新建视图
    } else {
        cell.cellImg.isHidden = false
        cell.cellImg.image = UIImage(named:"RightAnswerNew")
        
        // 根据选中状态设置按钮
        let lessonID = lesson.id // 假设Lesson模型有id属性
        let isSelected = CommonClass.selectedLessonIDs.contains(lessonID)
        if isSelected {
            cell.cellBtn.isHidden = false
            cell.cellBtn.setTitle("\(CommonClass.NbOfLessonsSelected)", for: .normal)
            cell.cellBtn.backgroundColor = .green
        } else {
            cell.cellBtn.isHidden = true
        }
    }
    
    // 绑定单元格索引
    cell.index = indexPath
    
    return cell
}

2. 将按钮状态与数据模型绑定，而非仅依赖控件 #

你当前直接修改控件状态，复用后没有数据支撑恢复状态，必须把选中状态存储在数据模型或全局集合里：

• 新增全局集合记录选中的课程ID：static var selectedLessonIDs = Set<Int>()（在CommonClass里）
• 修改按钮点击事件，更新数据集合并刷新对应行：

@IBAction func buyBtnPressed(_ sender: Any) {
    guard let lesson = lessonsArray[index.row] else { return }
    let lessonID = lesson.id
    let isSelected = CommonClass.selectedLessonIDs.contains(lessonID)
    
    if CommonClass.lessonBonus > 0 {
        if !isSelected {
            // 选中课程
            CommonClass.lessonBonus -= 1
            CommonClass.NbOfLessonsSelected += 1
            CommonClass.selectedLessonIDs.insert(lessonID)
            cellBtn.setTitle("\(CommonClass.NbOfLessonsSelected)", for: .normal)
            cellBtn.backgroundColor = .green
        } else {
            // 取消选中
            if CommonClass.removeOnlyAllowed == 1 {
                CommonClass.lessonBonus += 1
                CommonClass.NbOfLessonsSelected -= 1
                CommonClass.selectedLessonIDs.remove(lessonID)
                cellBtn.setTitle("Get", for: .normal)
                cellBtn.backgroundColor = .clear
                CommonClass.removeOnlyAllowed = 0
            } else {
                CommonClass.lessonBonus += 1
                CommonClass.NbOfLessonsSelected -= 1
                CommonClass.selectedLessonIDs.remove(lessonID)
                cellBtn.setTitle("Get", for: .normal)
                cellBtn.backgroundColor = .clear
            }
        }
    }
    
    // 刷新当前行，确保状态同步
    if let tableView = self.superview as? UITableView {
        tableView.reloadRows(at: [index], with: .automatic)
    }
}

3. 修复代码里的无效操作 #

• 不要在cellForRowAt里创建新的UIImageView，这不会添加到单元格上，直接修改已有的cell.cellImg的属性即可
• 确保cell.index正确赋值，避免索引错误导致的状态混乱

核心原则 #

UITableView复用单元格时，只会把旧单元格重新分配给新的indexPath，不会自动重置控件状态。所以必须在cellForRowAt里为每个控件设置明确的状态，不管是显示/隐藏、文字、颜色还是图片，不能依赖控件的默认值或之前的状态。

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