重载UITableView后indexPath.row值异常，末尾标签错误添加求助

问题根源 #

1. Cell复用残留：UITableView的Cell是复用机制，你直接调用addEndLocationLabel()会在Cell上重复添加标签，复用旧Cell时这些标签不会自动移除，导致随机显示。
2. 闭包捕获旧IndexPath：你在闭包中直接捕获了当时的indexPath，当Cell被复用或数据源变更后，这个旧的indexPath对应的数据源位置可能已经失效，导致后续操作逻辑错误。
3. 状态未重置：没有在Cell复用时重置显示状态，旧的标签、线条会保留在复用Cell上。

解决方案 #

1. 重构Cell类，统一状态控制

给你的Cell子类添加明确的状态配置方法，并在prepareForReuse中重置状态，避免复用残留：

class BusCell: UITableViewCell {
    // 提前初始化好需要的控件（不要每次add）
    private let endLocationLabel = UILabel()
    private let prevLineView = UIView()
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        // 初始化时添加控件到contentView，设置布局约束
        contentView.addSubview(endLocationLabel)
        contentView.addSubview(prevLineView)
        // ... 添加约束代码
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override func prepareForReuse() {
        super.prepareForReuse()
        // 重置所有可复用状态
        endLocationLabel.isHidden = true
        prevLineView.isHidden = true
        // 其他需要重置的状态，比如文本、颜色等
    }
    
    // 统一配置末尾标签
    func setShowEndLocation(_ show: Bool) {
        endLocationLabel.isHidden = !show
    }
    
    // 统一配置前置线条
    func setShowPrevLine(_ show: Bool, color: UIColor) {
        prevLineView.isHidden = !show
        prevLineView.backgroundColor = color
    }
    
    // 你的configure方法
    func configure(showStops: Bool, toggleAction: @escaping () -> Void) {
        // 原有configure逻辑
        // ...
    }
}

2. 修改cellForRowAt逻辑，避免捕获旧IndexPath

在闭包中不要依赖捕获的indexPath，而是通过当前Cell获取最新的IndexPath，同时每次配置Cell时都明确设置所有状态：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "BusCell", for: indexPath) as! BusCell
    
    let route = allDirections.directions.routes[indexPath.row]
    let type = route.type
    
    switch type {
    case .walk:
        // walk类型Cell的配置逻辑
        // ...
    case .bus:
        let showStops = route.stopsIsShown
        cell.configure(showStops: showStops) { [weak self] in
            guard let self = self else { return }
            // 通过当前Cell获取最新的IndexPath，避免旧路径失效
            guard let currentIndexPath = tableView.indexPath(for: cell) else { return }
            // 操作最新IndexPath对应的数据源
            self.allDirections.directions.routes[currentIndexPath.row].stopsIsShown.toggle()
            DispatchQueue.main.async {
                self.tableView.reloadRows(at: [currentIndexPath], with: .automatic)
            }
        }
        
        // 明确设置末尾标签状态
        let isLastRow = indexPath.row == allDirections.directions.routes.count - 1
        cell.setShowEndLocation(isLastRow)
        
        // 明确设置前置线条状态
        let hasPrevLine = indexPath.row > 0
        cell.setShowPrevLine(hasPrevLine, color: color)
        
        return cell
    }
}

核心注意点 #

• 永远不要在cellForRowAt中动态添加/移除控件，提前在Cell初始化时添加，通过显示/隐藏控制状态。
• 闭包中涉及数据源操作时，必须使用当前Cell对应的最新IndexPath，避免捕获旧的路径对象。
• 利用prepareForReuse重置所有可复用状态，从根源避免复用残留问题。

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