自动布局下标签重叠：已配置约束与行高仍未解决

API 探路者

2026-5-21

可能的问题排查方向

既然已经确认顶部Label不是问题所在，那咱们可以把重点放在底部Label、Cell布局逻辑和TableView行高计算这几个维度来排查：

底部Label的约束链不完整：你只给底部Label加了leading约束和与顶部Label的顶部间距，但如果缺少trailing约束、底部约束（或者没有设置内容的压缩/抗压缩优先级），就会导致布局异常。比如：
- 如果没有trailing约束，当底部Label文本过长时，会直接撑破Cell的宽度；
- 如果没设置Content Hugging Priority和Content Compression Resistance Priority，当Label内容和其他布局逻辑冲突时，系统可能会自动调整Label的大小，出现不符合预期的显示效果。
Cell的布局载体错误：有没有把底部Label的约束加在contentView上？很多新手会误把约束直接加在Cell本身（而不是contentView），这会导致TableView复用Cell时布局失效。你可以检查下约束的父控件是不是contentView。
TableView行高的设置冲突：如果你的TableView同时设置了固定rowHeight和estimatedRowHeight，或者estimatedRowHeight设置得和实际行高偏差太大，系统的自动行高计算就会出错。比如你用了UITableView.automaticDimension来实现自适应行高，但没有确保从Cell的top到bottom有完整的约束链（比如底部Label没和contentView的bottom建立约束），系统就无法正确计算行高。
底部Label的文本显示配置问题：比如numberOfLines设置为1但文本过长，或者设置为0（自动换行）但没有足够的宽度约束；还有lineBreakMode的设置是否符合预期，这些配置问题有时候会被误以为是约束问题。
隐藏的约束冲突：虽然你删除并重新连接了约束，但可能还是存在隐性的冲突。你可以打开Xcode的Debug View Hierarchy查看底部Label的约束状态，有没有红色的冲突标记；也可以查看控制台日志，系统会打印被自动打破的约束信息，从中找到问题根源。