Swift中UITableView内UIButton选中状态图片仅最后一个变更问题求助

嘿，这个问题我太熟了！你遇到的是UITableView cell复用 + 全局变量误用导致的典型问题，我来给你拆解一下并解决它～

问题根源 #

你把buttonSelect定义成了全局变量，而UITableView的cell是会被复用的——每次调用cellForRowAt创建新cell时，这个全局变量都会被覆盖成当前cell里的按钮。当你想修改选中状态时，它只会指向最后一次创建的那个按钮（也就是最后一行的按钮），自然只有最后一个按钮会有反应。

解决方案：用数据模型跟踪状态 + 避免全局变量 #

我们需要给每一行维护独立的选中状态，同时让每个按钮自己管理自己的选中逻辑，以下是两种常用的实现方式：

方式1：基础版（用Tag + 数据数组） #

首先定义一个数据模型来记录每行的按钮状态，然后在按钮点击时更新对应行的状态：

// 定义数据模型，记录每行的选中状态
struct RowItem {
    var isButtonSelected: Bool = false
    // 这里可以添加你需要的其他数据字段
}

// 在ViewController中维护数据数组
var rowItems: [RowItem] = []

// 初始化时要给数组填充对应行数的数据，比如：
override func viewDidLoad() {
    super.viewDidLoad()
    // 假设你有10行数据
    rowItems = Array(repeating: RowItem(), count: 10)
}

// 重构cellForRowAt方法
override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    // 注意：这里要确保你的cell有正确的复用ID
    guard let cell = tableView.dequeueReusableCell(withIdentifier: "YourCellID", for: indexPath) else {
        return UITableViewCell()
    }
    
    // 先移除cell上的旧按钮（避免复用重复添加）
    cell.contentView.subviews.forEach { $0.removeFromSuperview() }
    
    // 创建按钮
    let buttonSelect = UIButton(frame: CGRect(x: 340, y: 40, width: 40, height: 21))
    // 设置正常/选中状态的图片
    let normalImg = UIImage(named: "normal_button")
    let selectedImg = UIImage(named: "selected_button")
    buttonSelect.setImage(normalImg, for: .normal)
    buttonSelect.setImage(selectedImg, for: .selected)
    
    // 根据数据模型设置初始选中状态
    let currentItem = rowItems[indexPath.row]
    buttonSelect.isSelected = currentItem.isButtonSelected
    
    // 设置tag为当前行号，用来区分点击的是哪一行
    buttonSelect.tag = indexPath.row
    buttonSelect.addTarget(self, action: #selector(buttonTapped(_:)), for: .touchUpInside)
    
    cell.contentView.addSubview(buttonSelect)
    return cell
}

// 按钮点击事件处理
@objc private func buttonTapped(_ sender: UIButton) {
    let row = sender.tag
    guard row < rowItems.count else { return }
    
    // 切换选中状态
    rowItems[row].isButtonSelected.toggle()
    sender.isSelected = rowItems[row].isButtonSelected
    
    // 如果需要刷新整个cell（比如有其他关联UI），可以调用：
    // tableView.reloadRows(at: [IndexPath(row: row, section: 0)], with: .automatic)
}

方式2：优雅版（自定义UITableViewCell） #

如果你的cell比较复杂，推荐用自定义cell来管理按钮，避免tag带来的潜在冲突：

// 自定义Cell
class CustomButtonCell: UITableViewCell {
    // 内部管理按钮
    private let selectButton: UIButton = {
        let btn = UIButton(frame: CGRect(x: 340, y: 40, width: 40, height: 21))
        btn.setImage(UIImage(named: "normal_button"), for: .normal)
        btn.setImage(UIImage(named: "selected_button"), for: .selected)
        return btn
    }()
    
    // 用闭包传递点击事件
    var onButtonTap: ((Bool) -> Void)?
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupCell()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupCell()
    }
    
    private func setupCell() {
        contentView.addSubview(selectButton)
        selectButton.addTarget(self, action: #selector(buttonTapped), for: .touchUpInside)
    }
    
    @objc private func buttonTapped() {
        selectButton.isSelected.toggle()
        onButtonTap?(selectButton.isSelected)
    }
    
    // 复用cell时重置状态
    override func prepareForReuse() {
        super.prepareForReuse()
        selectButton.isSelected = false
    }
    
    // 对外提供方法设置选中状态
    func configure(with isSelected: Bool) {
        selectButton.isSelected = isSelected
    }
}

// 在ViewController中使用
override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "CustomButtonCell", for: indexPath) as! CustomButtonCell
    let currentItem = rowItems[indexPath.row]
    cell.configure(with: currentItem.isButtonSelected)
    
    // 绑定点击事件
    cell.onButtonTap = { [weak self] isSelected in
        guard let self = self else { return }
        self.rowItems[indexPath.row].isButtonSelected = isSelected
    }
    return cell
}

这样不管cell怎么复用，每个按钮的状态都能和对应行的数据绑定，再也不会出现只有最后一个按钮生效的问题啦～

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