Swift：设置边缘到边缘约束后，UIScrollView子视图仍无法填满视图

这个问题我之前也碰到过，UIScrollView的约束逻辑和普通View有本质区别，稍不注意就会踩坑！咱们一步步来解决：

问题根源 #

UIScrollView的核心特性是它的contentSize（可滚动区域的大小）是由子视图的约束来定义的，而不是像普通View那样直接约束子视图到自身边缘来填充。如果只给子视图设置leading/trailing/top/bottom到UIScrollView的约束，UIScrollView会把这些约束用来计算contentSize，而不是强制子视图匹配自己的可视区域大小——这就导致子视图可能会根据自身内容收缩，无法填满滚动视图。

解决方案 #

针对你的代码，我们需要做两处关键修改：

1. 确保UIScrollView本身的约束正确 #

首先要把containerScrollView正确添加到父视图，并设置好它的边缘约束（固定到父视图的leading/trailing/top/bottom）：

override func viewDidLoad() { 
    super.viewDidLoad() 
    
    // 添加scrollView到父视图
    view.addSubview(containerScrollView)
    containerScrollView.translatesAutoresizingMaskIntoConstraints = false
    
    // 设置scrollView的约束，固定到父视图边缘
    NSLayoutConstraint.activate([
        containerScrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        containerScrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        containerScrollView.topAnchor.constraint(equalTo: view.topAnchor),
        containerScrollView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
    ])
    
    // 接下来处理galleryView的约束
    // ...
}

2. 给子视图添加关键的宽度约束（或使用Layout Guides） #

这里有两种推荐的方式，任选其一即可：

方式一：iOS 11+ 推荐使用Layout Guides

UIScrollView提供了frameLayoutGuide（对应滚动视图的可视区域）和contentLayoutGuide（对应可滚动的内容区域），用这两个Guide来约束子视图更清晰：

containerScrollView.addSubview(galleryView)
galleryView.translatesAutoresizingMaskIntoConstraints = false

NSLayoutConstraint.activate([
    // 让子视图和contentLayoutGuide绑定，定义scrollView的contentSize
    galleryView.leadingAnchor.constraint(equalTo: containerScrollView.contentLayoutGuide.leadingAnchor),
    galleryView.trailingAnchor.constraint(equalTo: containerScrollView.contentLayoutGuide.trailingAnchor),
    galleryView.topAnchor.constraint(equalTo: containerScrollView.contentLayoutGuide.topAnchor),
    galleryView.bottomAnchor.constraint(equalTo: containerScrollView.contentLayoutGuide.bottomAnchor),
    
    // 强制子视图宽度等于scrollView的可视区域宽度，实现填满效果
    galleryView.widthAnchor.constraint(equalTo: containerScrollView.frameLayoutGuide.widthAnchor)
])

方式二：兼容iOS 10及以下的传统写法

如果需要兼容更低版本，直接给子视图添加宽度等于scrollView的约束即可：

containerScrollView.addSubview(galleryView)
galleryView.translatesAutoresizingMaskIntoConstraints = false

NSLayoutConstraint.activate([
    galleryView.leadingAnchor.constraint(equalTo: containerScrollView.leadingAnchor),
    galleryView.trailingAnchor.constraint(equalTo: containerScrollView.trailingAnchor),
    galleryView.topAnchor.constraint(equalTo: containerScrollView.topAnchor),
    galleryView.bottomAnchor.constraint(equalTo: containerScrollView.bottomAnchor),
    
    // 关键：让子视图宽度和scrollView一致
    galleryView.widthAnchor.constraint(equalTo: containerScrollView.widthAnchor)
])

额外检查点 #

还要确认你的GalleryView内部的约束是否正确——如果GalleryView的子视图没有撑满它自身，也会导致视觉上看起来没填满scrollView的情况。确保GalleryView的内部视图也设置了从边缘到边缘的约束，让GalleryView能被内部内容撑满。

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