SwiftUI中VStack含Spacer时Text无法换行的原因解析

问题现象 #

在SwiftUI的List布局场景中，当VStack内部包含Spacer组件时，同一VStack里HStack中的Text控件无法正常换行；移除Spacer后，Text则能按照预期自动换行并遵守lineLimit限制。

代码示例 #

无法换行的代码 #

struct ContentView: View {
    var body: some View {
        List{
            VStack(alignment: .leading, spacing: 0) {
                HStack(alignment: .top, spacing: 0) {
                    Image(systemName: "globe")
                        .frame(width: 150, height: 50)
                        .imageScale(.large)
                        .foregroundStyle(.tint)
                    Text("Hello, world!Hello, world!Hello, world!Hello, world!").lineLimit(2)
                }
                Spacer().frame(width: 10, height: 1).background(Color.red)
            }
        }
    }
}

正常换行的代码 #

struct ContentView: View {
    var body: some View {
        List{
            VStack(alignment: .leading, spacing: 0) {
                HStack(alignment: .top, spacing: 0) {
                    Image(systemName: "globe")
                        .frame(width: 150, height: 50)
                        .imageScale(.large)
                        .foregroundStyle(.tint)
                    Text("Hello, world!Hello, world!Hello, world!Hello, world!").lineLimit(2)
                }
                // Spacer removed
            }
        }
    }
}

已知解决方案 #

给Text添加fixedSize(horizontal: false, vertical: true)修饰符，强制其在水平方向上遵循父容器的宽度约束，即可恢复正常换行：

Text("Hello, world!Hello, world!Hello, world!Hello, world!")
    .lineLimit(2)
    .fixedSize(horizontal: false, vertical: true)

原因分析 #

这本质是SwiftUI布局系统中父容器尺寸传递与子视图布局优先级的问题：

1. 没有Spacer时，VStack的水平尺寸完全由内部HStack的内容决定，而HStack会受到List单元格的宽度约束——List单元格的宽度是屏幕宽度（减去内边距），因此HStack会把剩余宽度分配给Text，Text在宽度不足时自动换行。
2. 加入Spacer后，哪怕你给Spacer设置了固定的宽高，VStack的布局逻辑会发生变化：它会向父容器（List单元格）申请尽可能大的垂直空间，同时在水平方向上，VStack不再严格限制内部HStack的宽度，导致HStack获得了“无边界”的水平空间感知。此时Text会按照自身的理想宽度（即一行显示所有内容的宽度）来布局，自然不会触发换行，哪怕设置了lineLimit也无效。

而fixedSize(horizontal: false, vertical: true)的作用是明确告诉Text：水平方向不要追求理想宽度，必须服从父视图的宽度约束；垂直方向可以自适应高度，这样Text就会重新受到HStack的宽度限制，进而自动换行。

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