UITableView表头视图动态高度适配问题：描述标签存在超大上下边距

看起来你遇到的问题是表头视图动态调整高度时，描述标签被不必要地拉伸了——这通常是因为标签的内容优先级没设置对，或者高度计算的方式没贴合标签的实际多行显示需求。我来给你几个针对性的解决办法：

1. 先调整描述标签的内容优先级 #

UILabel默认的垂直方向内容拥抱（Content Hugging）和压缩抵抗（Content Compression Resistance）优先级比较低，当父视图需要调整高度时，很容易被强制拉伸。你需要把这两个优先级拉满，确保标签只会贴合自身内容高度，不会被额外拉伸：

// 在viewDidLoad或者设置标签属性的地方添加
self.descriptionLabel.setContentHuggingPriority(.required, for: .vertical)
self.descriptionLabel.setContentCompressionResistancePriority(.required, for: .vertical)

2. 优化表头高度的计算逻辑 #

你之前用的UIView.layoutFittingCompressedSize会尽量压缩视图高度，和多行文本的展示需求不匹配。换成layoutFittingExpandedSize，并明确设置水平方向的优先级为必填，这样能更准确地计算出包含完整多行文本的表头高度：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    guard let headerView = tableView.tableHeaderView else { return }
    
    // 计算适配完整内容的表头高度
    let fittingSize = headerView.systemLayoutSizeFitting(
        UIView.layoutFittingExpandedSize,
        withHorizontalFittingPriority: .required, // 水平方向固定为表头当前宽度
        verticalFittingPriority: .fittingSizeLevel // 垂直方向完全适配内容
    )
    
    var headerFrame = headerView.frame
    // 加个小阈值避免浮点精度导致的无限循环
    if abs(fittingSize.height - headerFrame.height) > 1 {
        headerFrame.size.height = fittingSize.height
        headerView.frame = headerFrame
        tableView.tableHeaderView = headerView
    }
}

3. 排查Interface Builder中的约束问题 #

从你提到的截图来看，标签被上下拉伸，大概率是约束配置有问题：

• 确保描述标签没有设置固定高度约束，也没有height >=这类允许拉伸的约束
• 检查标签的上下约束：顶部要和上方的图片视图底部紧密相连，底部要和下方的按钮顶部紧密相连，形成完整的约束链
• 确认表头容器视图没有设置固定高度，它的高度完全由内部子视图的约束自动推导

4. 替代方案：设置文本后直接计算高度 #

如果上面的方法还是有问题，你可以跳过viewDidLayoutSubviews的方式，在给描述标签设置文本后直接计算并更新表头高度：

func updateHeader(with descriptionText: String) {
    self.descriptionLabel.text = descriptionText
    // 让标签先适配文本内容
    self.descriptionLabel.sizeToFit()
    
    guard let headerView = tableView.tableHeaderView else { return }
    // 计算表头的完整高度
    let headerHeight = headerView.systemLayoutSizeFitting(
        CGSize(width: tableView.bounds.width, height: UIView.layoutFittingExpandedSize.height),
        withHorizontalFittingPriority: .required,
        verticalFittingPriority: .fittingSizeLevel
    ).height
    
    var headerFrame = headerView.frame
    headerFrame.size.height = headerHeight
    headerView.frame = headerFrame
    tableView.tableHeaderView = headerView
}

按照这个流程调整后，应该能解决标签被拉伸的问题，同时保持表头高度动态适配文本内容。

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