UITableViewCell渲染异常：文本换行与布局约束问题排查

• UILabel换行配置未正确设置：如果标签的numberOfLines属性仍为默认的1，文本会直接截断而非自动换行；若lineBreakMode设置为NSLineBreakByTruncatingTail这类截断模式，也会阻止文本换行。需要将numberOfLines设为0，同时确保lineBreakMode为NSLineBreakByWordWrapping或NSLineBreakByCharWrapping。

• 缺少preferredMaxLayoutWidth配置：自动布局需要明确标签的最大可用宽度，才能计算换行后的高度。如果未设置该属性，系统无法确定标签的换行边界，导致文本无法正确换行，进而打乱单元格布局。可通过代码设置该属性为标签的可用宽度，或在Interface Builder中勾选“Preferred Width”的“Automatic”选项。

• 约束优先级与内容属性的冲突：

  • 标签左右约束优先级为1000（最高），但UILabel默认的水平内容压缩阻力优先级为750，和标签右侧到UISwitch的>=10约束优先级相同。当文本过长时，系统无法判断是压缩标签宽度满足换行需求，还是保持标签宽度忽略间距约束，最终导致布局错乱。
  • 可尝试将标签的水平内容压缩阻力优先级调低（比如设为749），让系统优先满足标签右侧的间距约束，同时允许标签宽度压缩以实现文本换行。

• UITableView自动行高未启用：如果未设置tableView.rowHeight = UITableView.automaticDimension和tableView.estimatedRowHeight = 44（或其他合理预估高度），单元格会使用固定高度。前3行文本较短，固定高度足够容纳，但后两行文本过长时，固定高度无法适配换行后的标签高度，导致布局挤压或文本截断。

• 潜在的约束歧义或冲突：检查是否存在其他未注意到的约束冲突（比如标签被设置了固定宽度、高度约束），这类约束会强制标签保持固定尺寸，无法根据文本长度调整，进而导致文本无法换行、布局错乱。

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