UIStackView未按文档采用最大子视图宽度，反而用最小宽度的问题咨询

核心原因 #

你的垂直UIStackView出现与预期不符的表现，本质是约束优先级冲突以及对StackView布局逻辑的理解偏差：

1. StackView自动约束的优先级：设置alignment = .fill时，StackView会为每个排列子视图添加「宽度等于StackView宽度」的约束，但该约束优先级为UILayoutPriorityDefaultHigh（750），低于required级（1000）。
2. 子视图固定宽度的优先级：你通过SnapKit添加的width.equalTo(xxx)默认是required级约束（1000），优先级高于StackView自动生成的约束。
3. StackView宽度未明确限定：仅为StackView设置top和left约束，未指定宽度或右边界，导致其宽度需由自动布局推导。

自动布局系统为满足所有required级约束，只能将StackView宽度压缩至最小子视图的宽度（100）：

• 宽度100的子视图与StackView宽度完全匹配，无冲突；
• 宽度200、300的子视图因StackView宽度被限定，其固定宽度约束与StackView的填充约束冲突，系统会强制压缩子视图宽度以匹配StackView（此时控制台会输出约束冲突日志）。

修正方案 #

若要实现「StackView取最大子视图宽度，所有子视图填充StackView」的效果，需调整约束逻辑：

1. 移除子视图的固定宽度约束：垂直StackView的宽度应由其自身根据子视图的布局需求自动计算，不要给子视图添加垂直于轴方向的固定约束（宽度）。
2. 通过内部约束或内容确定子视图宽度：如果需要子视图有不同宽度，可通过内部子视图的约束（如内部Label的宽度）或设置intrinsicContentSize来实现。
3. 保留StackView的位置约束：若需StackView靠左对齐，保留top和left约束即可，StackView会自动适配最大子视图的宽度。

修正后的代码 #

import Foundation
import UIKit
import SwiftUI
import SnapKit

class TestViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .white
        
        let stackView = UIStackView()
        stackView.axis = .vertical
        stackView.backgroundColor = .gray
        stackView.spacing = 20
        stackView.alignment = .fill
        stackView.translatesAutoresizingMaskIntoConstraints = false
        view.addSubview(stackView)
        
        // 保留top和left约束，让StackView靠左对齐（添加安全区偏移优化体验）
        stackView.snp.makeConstraints { make in
            make.top.equalTo(view.safeAreaLayoutGuide).offset(20)
            make.left.equalTo(view).offset(20)
        }
        
        // 子视图通过内部元素确定宽度，移除自身固定宽度约束
        let view1 = UIView()
        view1.backgroundColor = .red
        stackView.addArrangedSubview(view1)
        let innerView1 = UIView()
        innerView1.backgroundColor = .black
        view1.addSubview(innerView1)
        innerView1.snp.makeConstraints { make in
            make.width.equalTo(100)
            make.height.equalTo(50)
            make.edges.equalTo(view1)
        }
        
        let view2 = UIView()
        view2.backgroundColor = .green
        stackView.addArrangedSubview(view2)
        let innerView2 = UIView()
        innerView2.backgroundColor = .black
        view2.addSubview(innerView2)
        innerView2.snp.makeConstraints { make in
            make.width.equalTo(200)
            make.height.equalTo(50)
            make.edges.equalTo(view2)
        }
        
        let view3 = UIView()
        view3.backgroundColor = .blue
        stackView.addArrangedSubview(view3)
        let innerView3 = UIView()
        innerView3.backgroundColor = .black
        view3.addSubview(innerView3)
        innerView3.snp.makeConstraints { make in
            make.width.equalTo(300)
            make.height.equalTo(50)
            make.edges.equalTo(view3)
        }
    }
}

struct TestViewControllerTestView : UIViewControllerRepresentable {
    typealias UIViewControllerType = TestViewController
    func makeUIViewController(context: Context) -> TestViewController {
        return TestViewController()
    }
    func updateUIViewController(_ uiViewController: UIViewControllerType, context: Context) {}
}

struct TestViewController_Preview : PreviewProvider {
    static var previews: some View {
        TestViewControllerTestView()
    }
}

补充说明 #

Apple官方文档中「垂直于栈视图轴方向，其拟合尺寸等于最大排列子视图的尺寸」的描述，前提是子视图在该方向上无固定约束，StackView可自由计算拟合尺寸。当子视图添加固定宽度约束后，该逻辑会被打破——固定约束优先级更高，会强制StackView宽度适配子视图，而非子视图适配StackView。

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