iOS Swift：TableView内UILabel滑动手势添加及无响应问题排查

看起来你遇到了UITableViewCell内UILabel手势不响应的典型问题，我帮你梳理几个核心原因和对应的解决步骤：

1. 开启UILabel的用户交互权限 #

UILabel默认userInteractionEnabled是false，这是手势不响应的最常见原因！一定要先打开这个开关：

yourLabel.isUserInteractionEnabled = true

2. 正确在Cell复用流程中添加手势 #

你在viewDidLoad里创建手势的方式不对——因为UITableView的Cell是复用的，你需要在Cell的配置方法或者自定义Cell的初始化/awakeFromNib方法里添加手势，而不是在ViewController的viewDidLoad里。这里提供两种实现方式：

方式一：使用自定义UITableViewCell（推荐） #

创建自定义Cell类，在内部统一管理UI和手势逻辑：

class CheckListCell: UITableViewCell {
    // 定义Cell内的控件
    let itemLabel = UILabel()
    let radioButton = UIButton(type: .radio)
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupUI()
        setupGestures()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupUI()
        setupGestures()
    }
    
    // 布局UI
    private func setupUI() {
        // 开启Label的交互权限
        itemLabel.isUserInteractionEnabled = true
        // 初始隐藏单选按钮
        radioButton.isHidden = true
        
        // 添加控件到contentView并设置约束
        contentView.addSubview(itemLabel)
        contentView.addSubview(radioButton)
        
        itemLabel.translatesAutoresizingMaskIntoConstraints = false
        radioButton.translatesAutoresizingMaskIntoConstraints = false
        
        NSLayoutConstraint.activate([
            radioButton.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            radioButton.centerYAnchor.constraint(equalTo: contentView.centerYAnchor),
            itemLabel.leadingAnchor.constraint(equalTo: radioButton.trailingAnchor, constant: 12),
            itemLabel.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            itemLabel.centerYAnchor.constraint(equalTo: contentView.centerYAnchor)
        ])
    }
    
    // 添加滑动手势
    private func setupGestures() {
        // 单指滑动手势（示例为右滑，可根据需求修改方向）
        let singleSwipe = UISwipeGestureRecognizer(target: self, action: #selector(handleSingleSwipe(_:)))
        singleSwipe.direction = .right
        singleSwipe.numberOfTouchesRequired = 1
        itemLabel.addGestureRecognizer(singleSwipe)
        
        // 双指滑动手势
        let doubleSwipe = UISwipeGestureRecognizer(target: self, action: #selector(handleDoubleSwipe(_:)))
        doubleSwipe.direction = .right
        doubleSwipe.numberOfTouchesRequired = 2
        itemLabel.addGestureRecognizer(doubleSwipe)
    }
    
    // 单滑处理逻辑：显示/隐藏单选按钮
    @objc private func handleSingleSwipe(_ gesture: UISwipeGestureRecognizer) {
        radioButton.isHidden = !radioButton.isHidden
        // 如需通知ViewController，可通过delegate或闭包传递事件
    }
    
    // 双滑处理逻辑：添加虚线删除线
    @objc private func handleDoubleSwipe(_ gesture: UISwipeGestureRecognizer) {
        guard let text = itemLabel.text else { return }
        let attributedString = NSMutableAttributedString(string: text)
        attributedString.addAttribute(
            .strikethroughStyle,
            value: NSNumber(value: NSUnderlineStyle.dash.rawValue),
            range: NSRange(location: 0, length: text.count)
        )
        itemLabel.attributedText = attributedString
    }
    
    // 复用Cell时重置状态
    override func prepareForReuse() {
        super.prepareForReuse()
        radioButton.isHidden = true
        itemLabel.attributedText = nil
        itemLabel.text = ""
    }
}

然后在ViewController的cellForRowAt方法中使用该自定义Cell：

override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "CheckListCell", for: indexPath) as! CheckListCell
    cell.itemLabel.text = yourDataSource[indexPath.row]
    return cell
}

方式二：在Cell配置时动态添加手势（无自定义Cell） #

如果不想自定义Cell，可在cellForRowAt中给每个Cell的Label添加手势，但要注意避免重复添加（因Cell复用）：

override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
    guard let label = cell.viewWithTag(100) as? UILabel, let radioButton = cell.viewWithTag(200) as? UIButton else {
        return cell
    }
    
    // 开启Label交互权限
    label.isUserInteractionEnabled = true
    // 移除旧手势，避免重复添加
    label.gestureRecognizers?.forEach(label.removeGestureRecognizer)
    
    // 添加单滑手势
    let singleSwipe = UISwipeGestureRecognizer(target: self, action: #selector(handleSingleSwipe(_:)))
    singleSwipe.direction = .right
    label.addGestureRecognizer(singleSwipe)
    
    // 添加双滑手势
    let doubleSwipe = UISwipeGestureRecognizer(target: self, action: #selector(handleDoubleSwipe(_:)))
    doubleSwipe.direction = .right
    doubleSwipe.numberOfTouchesRequired = 2
    label.addGestureRecognizer(doubleSwipe)
    
    // 初始化控件状态
    radioButton.isHidden = true
    label.text = yourDataSource[indexPath.row]
    return cell
}

// ViewController内的手势处理方法
@objc private func handleSingleSwipe(_ gesture: UISwipeGestureRecognizer) {
    guard let label = gesture.view as? UILabel, 
          let cell = label.superview?.superview as? UITableViewCell,
          let radioButton = cell.viewWithTag(200) as? UIButton else {
        return
    }
    radioButton.isHidden = !radioButton.isHidden
}

@objc private func handleDoubleSwipe(_ gesture: UISwipeGestureRecognizer) {
    guard let label = gesture.view as? UILabel, let text = label.text else { return }
    let attributedString = NSMutableAttributedString(string: text)
    attributedString.addAttribute(
        .strikethroughStyle,
        value: NSNumber(value: NSUnderlineStyle.dash.rawValue),
        range: NSRange(location: 0, length: text.count)
    )
    label.attributedText = attributedString
}

3. 处理手势冲突（若TableView滚动与Label滑动方向一致） #

如果Label的滑动方向和TableView的滚动方向重叠（比如都是水平滑动），TableView的手势会优先响应，此时可通过手势代理允许同时识别：

// 在自定义Cell或ViewController中遵守UIGestureRecognizerDelegate
class CheckListCell: UITableViewCell, UIGestureRecognizerDelegate {
    // ... 之前的代码 ...
    
    private func setupGestures() {
        let singleSwipe = UISwipeGestureRecognizer(target: self, action: #selector(handleSingleSwipe(_:)))
        singleSwipe.direction = .right
        singleSwipe.delegate = self // 设置代理
        itemLabel.addGestureRecognizer(singleSwipe)
        
        let doubleSwipe = UISwipeGestureRecognizer(target: self, action: #selector(handleDoubleSwipe(_:)))
        doubleSwipe.direction = .right
        doubleSwipe.numberOfTouchesRequired = 2
        doubleSwipe.delegate = self
        itemLabel.addGestureRecognizer(doubleSwipe)
    }
    
    // 允许同时识别多个手势
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        return true
    }
}

4. 验证手势触发条件 #

确认滑动手势的direction（滑动方向）和numberOfTouchesRequired（触摸手指数量）设置符合你的需求。如果“双滑”指的是双击而非双指滑动，应使用UITapGestureRecognizer并设置numberOfTapsRequired = 2。

按照上述步骤调整代码后，应该就能解决UILabel滑动手势无响应的问题了！

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