如何在UITableViewCell内配置子视图UITapGestureRecognizer实现交互

这类问题90%以上的触发点都是以下几个，先逐一排查再写业务逻辑：

• 子视图的isUserInteractionEnabled被误关闭，比如xib勾选状态错配、代码里初始化时把交互关了
• 子视图被添加到层级错误的位置，比如加在cell的backgroundView（层级在contentView下方）、被透明但不交互的全屏视图完全盖住
• 手势被重复创建叠加在cell复用逻辑里，或者被cell、tableView自身的其他手势/滚动交互拦截
• 点击回调里拿不到对应的cell上下文，导致触发的操作和当前显示的行对不上

1. 基础手势配置（在自定义UITableViewCell内完成） #

所有手势初始化逻辑只在cell的初始化方法、awakeFromNib中执行一次，绝对不要在cellForRowAt代理方法里重复添加，否则cell复用时会叠加大量重复手势，单次点击会触发十几次回调。
在自定义cell内通过闭包暴露三个交互的出口，由控制器实现具体业务逻辑：

class InteractiveTableViewCell: UITableViewCell {
    // 交互回调出口
    var onBlueTap: ((IndexPath) -> Void)?
    var onRedTap: (() -> Void)?
    var onGreenTap: ((IndexPath) -> Void)?
    
    // 缓存当前绑定的行索引，解决复用时的上下文丢失问题
    private var boundIndexPath: IndexPath?
    
    // 对应三个子视图属性
    let blueView = UIView()
    let redView = UIView()
    let greenView = UIView()

    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupGestureBind()
    }

    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupGestureBind()
    }

    private func setupGestureBind() {
        // 给blueView绑定tap
        let blueTap = UITapGestureRecognizer(target: self, action: #selector(triggerBlueTap))
        blueView.addGestureRecognizer(blueTap)
        
        // 给redView绑定tap
        let redTap = UITapGestureRecognizer(target: self, action: #selector(triggerRedTap))
        redView.addGestureRecognizer(redTap)
        
        // 给greenView绑定tap
        let greenTap = UITapGestureRecognizer(target: self, action: #selector(triggerGreenTap))
        greenView.addGestureRecognizer(greenTap)
    }

    // cellForRowAt时同步绑定当前行的索引
    func bind(indexPath: IndexPath) {
        boundIndexPath = indexPath
    }

    @objc private func triggerBlueTap() {
        guard let indexPath = boundIndexPath else { return }
        onBlueTap?(indexPath)
    }

    @objc private func triggerRedTap() {
        onRedTap?()
    }

    @objc private func triggerGreenTap() {
        guard let indexPath = boundIndexPath else { return }
        onGreenTap?(indexPath)
    }

    // 复用时清空绑定，避免操作错行
    override func prepareForReuse() {
        super.prepareForReuse()
        boundIndexPath = nil
    }
}

2. 控制器侧的三个交互逻辑落地 #

• 点击blueView选中当前单元格：在onBlueTap回调中直接调用tableView.selectRow(at:animated:scrollPosition:)，同步更新cell的选中状态，因为是子视图触发的交互，不会走原生的didSelectRowAt方法，需要手动触发选中逻辑
• 点击redView弹出Alert：在onRedTap回调中拿到当前最顶层的展示控制器，把UIAlertController弹窗present出来，注意不能把cell当presenting源，cell是视图层级，没有控制器能力，会导致弹窗完全不展示
• 点击greenView调整单元格尺寸：在onGreenTap回调中更新存储行高的数据源模型，随后调用tableView.beginUpdates()/tableView.endUpdates()触发行高动画更新，不要直接修改cell的frame，UITableView会在滚动、布局时自动通过数据源返回的行高重置cell的frame，直接改的尺寸会失效

3. 最后补查的特殊场景 #

• 如果cell开启了侧滑删除功能，检查手势的cancelsTouchesInView属性，不要设置为true导致触摸被提前截断
• 如果cell同时绑定了长按手势、滑动手势，实现UIGestureRecognizerDelegate的shouldRecognizeSimultaneouslyWith方法，放开多个手势的共存权限，避免tap手势被其他手势压制
• 检查三个子视图的实际可点击区域：如果子视图被设置了clipsToBounds、超出父视图边界，实际点击响应区域为0的话，手势完全不会触发

内容的提问来源于stack exchange，提问作者Pedro Henrique Cavalcante de S