开发App遇异常：TableViewCell不显示但TableView方法正常执行

这种情况我开发时也踩过好几次坑——明明numberOfRowsInSection和cellForRowAt都在正常打印，数据也更新了，TableView就是一片空白，连个cell影子都看不到，真的让人头大！下面给你列几个最常见的排查方向，按顺序试一遍应该能找到问题：

1. 先确认Cell的注册与复用是否完全正确 #

这是最容易出错的点：

• 如果你用纯代码创建Cell，一定要在viewDidLoad里调用tableView.register(_:forCellReuseIdentifier:)注册，且注册的类和复用ID要和dequeueReusableCell里的完全一致，大小写都不能错！
• 如果你用XIB/Storyboard创建Cell，要确保Storyboard里Cell的Identifier和代码里的复用ID完全匹配，并且如果是XIB的话，要注册对应的XIB文件，而不是直接注册Cell类。

举个正确的例子：

override func viewDidLoad() {
    super.viewDidLoad()
    // 纯代码Cell注册
    tableView.register(CustomCell.self, forCellReuseIdentifier: "CustomCellID")
    // XIB Cell注册
    // tableView.register(UINib(nibName: "CustomCell", bundle: nil), forCellReuseIdentifier: "CustomCellID")
}

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "CustomCellID", for: indexPath) as! CustomCell
    // 配置Cell内容
    cell.contentLabel.text = yourDataArray[indexPath.row]
    return cell
}

2. 检查Cell的高度设置是否合理 #

很多时候cell不显示，其实是高度被设成0了：

• 如果你用手动设置高度，检查tableView(_:heightForRowAt:)的返回值是不是大于0，别不小心返回了0或者负数。
• 如果你用自动高度，一定要同时设置tableView.rowHeight = UITableView.automaticDimension和tableView.estimatedRowHeight（给一个合理的预估高度，比如44），否则自动高度不会生效，cell会被压缩成0高度。

自动高度的正确配置：

override func viewDidLoad() {
    super.viewDidLoad()
    tableView.rowHeight = UITableView.automaticDimension
    tableView.estimatedRowHeight = 60 // 根据你的Cell内容调整
}

3. 检查Cell内部的约束是否正确 #

如果Cell的内容视图里的控件（比如Label、ImageView）约束没设好，可能导致整个Cell高度为0，或者内容被挤出可视范围：

• 确保控件的约束是从top到bottom、leading到trailing都有明确的约束，让Auto Layout能计算出Cell的高度。
• 检查有没有约束冲突，冲突可能导致Auto Layout放弃计算，Cell高度异常。

4. 确认数据源数组真的有数据 #

虽然你说数据变量已更新，但还是建议在numberOfRowsInSection里打印数组的count，比如：

func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    let count = yourDataArray.count
    print("当前数据条数：\(count)")
    return count
}

如果打印出来是0，那说明数据根本没加载进来，可能是异步加载数据的时机不对，或者数据解析出了问题。

5. 检查TableView本身的Frame和布局 #

有时候不是Cell的问题，是TableView本身被隐藏或者Frame不对：

• 检查TableView的frame是不是CGRect.zero，或者被其他视图（比如NavigationBar、TabBar）完全挡住了。
• 如果TableView在NavigationController里，有没有设置正确的contentInset，避免被导航栏遮挡。

6. 检查Cell的初始化和配置代码 #

看看你的Cell类里有没有不小心把内容隐藏的代码，比如在awakeFromNib或者init(style:reuseIdentifier:)里写了label.isHidden = true，或者把控件的alpha设成0了。

7. 确保刷新操作在主线程执行 #

如果你的数据是异步加载的，一定要回到主线程调用tableView.reloadData()，否则刷新可能不生效：

// 比如网络请求完成后
DispatchQueue.main.async {
    self.yourDataArray = newData
    self.tableView.reloadData()
}

8. 临时测试Cell的可见性 #

可以临时把Cell的背景色改成鲜艳的颜色，比如红色，看看是不是Cell其实存在，但背景色和TableView一样导致看不见：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "CustomCellID", for: indexPath) as! CustomCell
    cell.backgroundColor = .red // 临时测试
    cell.contentLabel.text = yourDataArray[indexPath.row]
    return cell
}

按这个顺序排查，基本能找到问题所在！

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