为何UITableView的contentLayoutGuide.layoutFrame始终为CGRect.zero？

你遇到的这个问题其实很常见——UITableView的contentLayoutGuide和普通UIScrollView的不太一样，它的布局帧依赖于tableView的contentSize，而contentSize是在tableView加载并布局完所有cell之后才会计算出有效值的。在viewDidLoad或者布局初期，contentLayoutGuide的layoutFrame确实会是CGRect.zero，这时候加的约束自然不会生效。

下面给你两种靠谱的解决方案，优先推荐第一种：

方案一：使用UITableView原生的tableFooterView（最稳定） #

UITableView本身就提供了在内容底部添加视图的机制——tableFooterView，这是Apple设计用来处理这类需求的，比手动加约束要可靠得多，还能自动跟随contentSize变化调整位置。

示例代码：

// 创建你需要的底部标签
let footerLabel = UILabel()
footerLabel.text = "这是内容底部的视图"
footerLabel.numberOfLines = 0
footerLabel.translatesAutoresizingMaskIntoConstraints = false

// 用一个容器视图包裹标签（因为tableFooterView需要明确的尺寸）
let footerContainer = UIView()
footerContainer.addSubview(footerLabel)

// 给标签添加约束到容器
NSLayoutConstraint.activate([
    footerLabel.topAnchor.constraint(equalTo: footerContainer.topAnchor, constant: 10),
    footerLabel.leadingAnchor.constraint(equalTo: footerContainer.leadingAnchor, constant: 16),
    footerLabel.trailingAnchor.constraint(equalTo: footerContainer.trailingAnchor, constant: -16),
    footerLabel.bottomAnchor.constraint(equalTo: footerContainer.bottomAnchor, constant: -10)
])

// 设置tableView的tableFooterView
tableView.tableFooterView = footerContainer

这样设置后，不管tableView的cell数量怎么变，这个footer都会自动固定在内容的最底部，完全不需要你手动处理约束更新的问题。

方案二：如果一定要用contentLayoutGuide #

如果你因为特殊需求必须用contentLayoutGuide，那你需要确保在tableView的contentSize已经计算完成后再添加约束，同时避免重复创建视图和约束。

示例代码：

// 定义一个可选变量保存约束，避免重复添加
private var bottomLabelConstraint: NSLayoutConstraint?
private lazy var bottomLabel: UILabel = {
    let label = UILabel()
    label.text = "用contentLayoutGuide实现的底部视图"
    label.translatesAutoresizingMaskIntoConstraints = false
    // 注意：如果把标签加到tableView上，需要关闭裁剪才能看到超出tableView边界的部分
    tableView.clipsToBounds = false
    tableView.addSubview(label)
    return label
}()

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    
    // 只有当contentSize有效且约束未添加时，才创建约束
    guard tableView.contentSize.height > 0, bottomLabelConstraint == nil else {
        return
    }
    
    bottomLabelConstraint = bottomLabel.topAnchor.constraint(equalTo: tableView.contentLayoutGuide.bottomAnchor, constant: 10)
    NSLayoutConstraint.activate([
        bottomLabelConstraint!,
        bottomLabel.leadingAnchor.constraint(equalTo: tableView.leadingAnchor, constant: 16),
        bottomLabel.trailingAnchor.constraint(equalTo: tableView.trailingAnchor, constant: -16),
        bottomLabel.heightAnchor.constraint(equalToConstant: 44)
    ])
}

⚠️ 注意：如果把视图加到tableView本身，一定要设置tableView.clipsToBounds = false，否则视图会被tableView的边界裁剪掉；另外，这种方式在tableView的contentSize变化时，约束会自动更新，但需要确保只添加一次约束，避免出现冲突。

总的来说，优先用tableFooterView，这是最符合UITableView设计逻辑的方案，能避免很多潜在的布局问题。

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