ScrollView已顶格布局，添加UISearchBar后为何未居顶？

问题代码 #

let scrollView = UIScrollView()
scrollView.translatesAutoresizingMaskIntoConstraints = false
self.view.addSubview(scrollView)
NSLayoutConstraint.activate([
    scrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
    scrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
    scrollView.topAnchor.constraint(equalTo: view.topAnchor),
    scrollView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
])
scrollView.backgroundColor = .green
let searchBar = UISearchBar()
searchBar.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    searchBar.heightAnchor.constraint(equalToConstant: 44.0),
    searchBar.widthAnchor.constraint(equalToConstant: UIScreen.main.bounds.width)
])
let size = CGSize(width: UIScreen.main.bounds.width, height: UIScreen.main.bounds.height + 44.0)
scrollView.addSubview(searchBar)
scrollView.contentSize = size

原因分析 #

1. 缺少位置约束：仅给searchBar设置了宽高约束，但未指定它相对于scrollView的位置锚点（如top、leading），布局系统无法确定searchBar在scrollView内的准确位置，导致无法对齐到顶部。
2. 手动设置contentSize冲突：手动赋值scrollView.contentSize会和Auto Layout的自动计算逻辑冲突，scrollView的contentSize应通过子视图的约束自动推导，手动设置容易引发布局偏移。

修正方案 #

1. 给searchBar添加相对于scrollView的位置约束，确保对齐顶部和左右边缘；
2. 删除手动设置contentSize的代码，让Auto Layout自动计算。

修正后的代码：

let scrollView = UIScrollView()
scrollView.translatesAutoresizingMaskIntoConstraints = false
self.view.addSubview(scrollView)
NSLayoutConstraint.activate([
    scrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
    scrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
    scrollView.topAnchor.constraint(equalTo: view.topAnchor),
    scrollView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
])
scrollView.backgroundColor = .green

let searchBar = UISearchBar()
searchBar.translatesAutoresizingMaskIntoConstraints = false
scrollView.addSubview(searchBar) // 先添加子视图再激活约束，避免布局异常

NSLayoutConstraint.activate([
    searchBar.topAnchor.constraint(equalTo: scrollView.topAnchor),
    searchBar.leadingAnchor.constraint(equalTo: scrollView.leadingAnchor),
    searchBar.trailingAnchor.constraint(equalTo: scrollView.trailingAnchor),
    searchBar.heightAnchor.constraint(equalToConstant: 44.0)
])
// 移除手动设置contentSize的代码

补充说明 #

如果后续scrollView内添加更多子视图，只要保证所有子视图的约束形成完整布局链（从scrollView的top到底部有连续约束关联），Auto Layout会自动计算出正确的contentSize，无需手动干预。

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