如何实现承载动态宽度内容的横向UIScrollView？

现有代码核心问题 #

• 错误将 contentLayoutGuide 锚点绑定到了父视图，contentLayoutGuide 的作用是定义 UIScrollView 的内容尺寸，它的约束只需要和内部子视图（即 UILabel）绑定即可
• 手动在 viewDidLayoutSubviews 中设置 contentSize 多余，使用 Auto Layout 时系统会自动根据约束计算内容尺寸，手动设置会和自动计算冲突
• 未显式关闭视图的 translatesAutoresizingMaskIntoConstraints，也没有配置 UILabel 的抗压缩优先级，可能导致 UILabel 文本被默认压缩折行

正确实现步骤 #

1. 基础属性配置 #

初始化 UILabel 和 UIScrollView 时添加如下配置：

// 禁止自动生成约束
scrollView.translatesAutoresizingMaskIntoConstraints = false
label.translatesAutoresizingMaskIntoConstraints = false

// 配置UILabel：不折行、抗压缩/抗拉伸优先级高于默认值，保证文本完整展示不被压缩
label.numberOfLines = 1
label.setContentHuggingPriority(.defaultHigh, for: .horizontal)
label.setContentCompressionResistancePriority(.defaultHigh, for: .horizontal)

2. 约束配置 #

func setupScrollView() {
    view.addSubview(scrollView)
    scrollView.addSubview(label)
    
    let frameLayoutGuide = scrollView.frameLayoutGuide
    // UIScrollView 自身的位置尺寸约束，原有逻辑无需修改
    NSLayoutConstraint.activate([
        frameLayoutGuide.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor, constant: 400),
        frameLayoutGuide.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 100),
        frameLayoutGuide.trailingAnchor.constraint(equalTo: view.trailingAnchor, constant: -100),
        frameLayoutGuide.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor, constant: -300),
    ])
    
    let contentLayoutGuide = scrollView.contentLayoutGuide
    // 内容约束：直接将UILabel和contentLayoutGuide四边绑定即可
    NSLayoutConstraint.activate([
        label.topAnchor.constraint(equalTo: contentLayoutGuide.topAnchor),
        label.leadingAnchor.constraint(equalTo: contentLayoutGuide.leadingAnchor),
        label.trailingAnchor.constraint(equalTo: contentLayoutGuide.trailingAnchor),
        label.bottomAnchor.constraint(equalTo: contentLayoutGuide.bottomAnchor),
        // 可选配置：如果不需要垂直滚动，绑定label高度和scrollView可视区域高度一致
        label.heightAnchor.constraint(equalTo: frameLayoutGuide.heightAnchor)
    ])
}

3. 冗余代码清理 #

删除 viewDidLayoutSubviews 中手动设置 contentSize 的代码。 #

效果说明 #

后续只要修改 label.text，系统会自动根据文本长度计算 UILabel 宽度，同步更新 UIScrollView 的 contentSize，无需额外手动刷新。如果需要适配多行文本垂直滚动，将 label.numberOfLines 设为0，删除可选的高度约束即可。

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