如何为UITableViewCell内嵌UITableView调用didSelectRow方法及选中异常排查

API 探路者

2026-5-12

问题原因与解决方案

为什么点击内嵌tableview1的cell会触发主UITableView的选中事件？

这本质是iOS触摸事件响应链的传递逻辑导致的：

当你点击屏幕上的某个视图时，系统会从最上层的视图开始检查是否能响应这个触摸事件。
如果内嵌的tableview1没有正确消费这个点击事件（比如没设置代理、没实现didSelectRowAt方法，或者userInteractionEnabled被意外关闭），事件就会沿着响应链向上冒泡，最终被主UITableView的Cell捕获，进而触发主tableview的选中回调。
另外，如果主tableview的Cell没有设置selectionStyle = .none，即使事件被内嵌tableview处理，有时候也会出现主Cell短暂选中的视觉效果（不过逻辑上不会触发主tableview的didSelectRowAt）。

如何让内嵌tableview1正常调用自己的`didSelectRow`方法？

核心思路是让内嵌tableview成为触摸事件的响应者，并把选中事件传递给主控制器，具体步骤如下：

1. 自定义包含内嵌tableview的Cell子类

首先在Cell内部初始化并配置内嵌tableview，同时设置它的数据源和代理为Cell本身，然后通过代理协议或者闭包把选中事件传递出去：

class NestedTableViewCell: UITableViewCell, UITableViewDataSource, UITableViewDelegate {
    // 内嵌tableview
    private let innerTableView = UITableView()
    
    // 定义代理协议，用于传递内嵌tableview的选中事件
    protocol NestedTableViewCellDelegate: AnyObject {
        func innerTableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath)
    }
    
    weak var delegate: NestedTableViewCellDelegate?
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupInnerTableView()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupInnerTableView()
    }
    
    private func setupInnerTableView() {
        // 设置内嵌tableview的布局
        innerTableView.frame = contentView.bounds
        innerTableView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        // 绑定数据源和代理到当前Cell
        innerTableView.dataSource = self
        innerTableView.delegate = self
        // 注册Cell
        innerTableView.register(UITableViewCell.self, forCellReuseIdentifier: "InnerCell")
        // 确保开启交互（默认是YES，这里显式设置更稳妥）
        innerTableView.isUserInteractionEnabled = true
        // 关闭主Cell的选中样式，避免视觉混淆
        self.selectionStyle = .none
        
        contentView.addSubview(innerTableView)
    }
    
    // MARK: - UITableViewDataSource
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return 4 // 根据你的实际数据返回行数
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "InnerCell", for: indexPath)
        cell.textLabel?.text = "内嵌行 \(indexPath.row + 1)"
        return cell
    }
    
    // MARK: - UITableViewDelegate
    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        // 取消选中状态（可选，提升用户体验）
        tableView.deselectRow(at: indexPath, animated: true)
        // 通过代理把事件传递给主控制器
        delegate?.innerTableView(tableView, didSelectRowAt: indexPath)
    }
}

2. 在主控制器中处理内嵌tableview的选中事件

主控制器需要遵守Cell的代理协议，在配置Cell时设置代理，然后实现代理方法来处理内嵌tableview的选中：

class MainViewController: UIViewController, UITableViewDataSource, UITableViewDelegate, NestedTableViewCellDelegate {
    private let mainTableView = UITableView()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupMainTableView()
    }
    
    private func setupMainTableView() {
        mainTableView.frame = view.bounds
        mainTableView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        mainTableView.dataSource = self
        mainTableView.delegate = self
        mainTableView.register(NestedTableViewCell.self, forCellReuseIdentifier: "NestedCell")
        view.addSubview(mainTableView)
    }
    
    // MARK: - UITableViewDataSource
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return 2 // 主tableview的行数
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "NestedCell", for: indexPath) as! NestedTableViewCell
        // 设置Cell的代理为当前控制器
        cell.delegate = self
        return cell
    }
    
    // MARK: - NestedTableViewCellDelegate
    func innerTableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        // 这里就是内嵌tableview的选中回调，处理你的业务逻辑
        print("点击了内嵌tableview的第 \(indexPath.row + 1) 行")
    }
}

额外注意点

确保内嵌tableview的frame设置正确，不要超出Cell的范围，否则部分点击可能不会被内嵌tableview捕获。
如果不想用代理，也可以用闭包来传递事件，写法更简洁，比如在Cell中定义var onInnerRowSelected: ((IndexPath) -> Void)?，然后在didSelectRowAt中调用onInnerRowSelected?(indexPath)，主控制器配置Cell时设置cell.onInnerRowSelected = { indexPath in ... }。

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