UITableViewCell按钮显示异常求助：滚动后未截断文本单元格误显按钮

嗨，这个问题我太熟悉了！本质是UITableView的单元格复用机制在搞鬼，我来给你拆解一下原因和解决办法：

UITableView为了提升滚动性能，会复用那些已经滚出屏幕的单元格。举个例子：某个单元格因为文本截断显示了按钮，当它滚出屏幕后，会被重新拿来展示新的内容。如果你没有在复用的时候重置按钮的隐藏状态，这个按钮就会保持之前“显示”的状态，导致本来文本没截断的单元格也莫名出现按钮。

你需要在两个关键环节处理按钮的状态，彻底解决复用带来的残留问题：

1. 在cellForRowAt中先重置状态，再判断显示 #

每次获取复用单元格时，先默认把按钮设为隐藏，再根据当前单元格的文本是否截断来决定是否显示按钮。代码示例如下：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "ItemCell", for: indexPath) as! ItemCell
    let currentItem = yourDataSourceArray[indexPath.row]
    
    // 第一步：先重置按钮为隐藏状态，避免复用残留
    cell.yourButton.isHidden = true
    
    // 第二步：设置当前单元格的文本和图片
    cell.yourLabel.text = currentItem.content
    cell.itemImageView.image = currentItem.image
    
    // 第三步：检查文本是否截断，再决定是否显示按钮
    cell.yourLabel.layoutIfNeeded() // 必须调用，确保Label完成布局计算
    if cell.yourLabel.isTruncated {
        cell.yourButton.isHidden = false
    }
    
    return cell
}

2. 给UILabel添加判断截断的扩展 #

系统没有直接提供判断文本是否截断的API，你需要自己写一个扩展来实现这个功能：

extension UILabel {
    var isTruncated: Bool {
        guard let labelText = self.text else { return false }
        
        let textSize = (labelText as NSString).boundingRect(
            with: CGSize(width: self.frame.width, height: CGFloat.greatestFiniteMagnitude),
            options: .usesLineFragmentOrigin,
            attributes: [.font: self.font ?? UIFont.systemFont(ofSize: 17)],
            context: nil
        ).size
        
        return textSize.height > self.bounds.height
    }
}

3. 额外保险：重写prepareForReuse方法 #

在你的自定义ItemCell类里重写prepareForReuse方法，在这里统一重置所有可能被复用影响的状态，进一步避免残留：

class ItemCell: UITableViewCell {
    @IBOutlet weak var itemImageView: UIImageView!
    @IBOutlet weak var yourLabel: UILabel!
    @IBOutlet weak var yourButton: UIButton!
    
    override func prepareForReuse() {
        super.prepareForReuse()
        // 重置所有复用会影响的控件状态
        yourButton.isHidden = true
        yourLabel.text = nil
        itemImageView.image = nil
    }
}

• prepareForReuse会在单元格被重新使用前自动调用，提前清空旧状态，从根源避免残留。
• 在cellForRowAt中先隐藏按钮，再根据当前数据判断是否显示，确保每个单元格的状态都是基于当前展示的数据，而不是复用的旧数据。

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