UITableViewCell按钮隐藏异常：文本未截断时按钮仍显示

我之前踩过一模一样的坑！控制台输出正确但界面和预期不符，十有八九是布局时机的问题——你大概率是在cell的布局还没完全敲定的时候就判断了文本是否截断，这时候计算出来的结果是错的，但等布局真正完成后，你没重新触发判断去更新按钮状态。下面给你几个具体的解决思路：

1. 确保在布局完成后判断截断状态 #

不要在cellForRowAt里直接做判断，因为此时cell的frame可能还没被正确设置（尤其是tableView还没完成布局的时候）。建议把判断逻辑放到自定义cell的layoutSubviews方法里，或者在需要判断前先强制触发布局：

第一步：给UILabel加个判断截断的扩展 #

extension UILabel {
    var isTruncated: Bool {
        guard let text = text, let font = font else { return false }
        // 计算文本在无限高度下的实际尺寸
        let labelMaxSize = CGSize(width: bounds.width, height: .greatestFiniteMagnitude)
        let textActualSize = text.boundingRect(
            with: labelMaxSize,
            options: .usesLineFragmentOrigin,
            attributes: [.font: font],
            context: nil
        ).size
        // 比较文本实际高度和label的显示高度
        return textActualSize.height > bounds.height
    }
}

第二步：在布局完成后更新按钮状态 #

如果是自定义UITableViewCell，重写layoutSubviews：

class CustomCell: UITableViewCell {
    @IBOutlet weak var titleLabel: UILabel!
    @IBOutlet weak var expandButton: UIButton!

    override func layoutSubviews() {
        super.layoutSubviews()
        // 先强制更新label的布局，确保bounds是最新的
        titleLabel.layoutIfNeeded()
        // 判断是否截断，更新按钮显示
        expandButton.isHidden = !titleLabel.isTruncated
    }
}

如果不是自定义cell，在cellForRowAt里也要先强制布局再判断：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath) as! CustomCell
    cell.titleLabel.text = yourDataArray[indexPath.row]
    
    // 强制布局cell和label
    cell.layoutIfNeeded()
    cell.titleLabel.layoutIfNeeded()
    
    cell.expandButton.isHidden = !cell.titleLabel.isTruncated
    return cell
}

2. 检查Auto Layout约束是否正确 #

有时候控制台输出正确但界面不对，可能是label的约束没设置到位：

• 确保label的leading、trailing约束是直接绑定到cell的contentView，没有额外的不确定内边距
• 确认label的行数设置正确（比如你要多行显示的话，行数设为0）
• 检查label的lineBreakMode是否设置为.byTruncatingTail或你需要的截断模式

3. 处理cell复用的状态残留 #

因为tableView的cell是复用的，之前cell的按钮状态可能会残留到新的cell上，所以要在prepareForReuse里重置状态：

override func prepareForReuse() {
    super.prepareForReuse()
    expandButton.isHidden = true
    titleLabel.text = nil
}

4. iOS 16+ 用系统原生属性 #

如果你的项目支持iOS 16及以上，直接用系统提供的isTruncated属性更可靠，不用自己计算：

// 注意要结合lineBreakMode判断，避免非截断场景误判
let isTruncated = titleLabel.lineBreakMode == .byTruncatingTail && titleLabel.isTruncated
expandButton.isHidden = !isTruncated

核心思路就是：必须等布局完全确定后再判断文本是否截断，同时处理好cell复用的状态重置，这样就能解决控制台输出正确但界面不符的问题了。

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