SwiftUI中Button位置为何影响PreferenceKey的传播？

开发macOS SwiftUI项目时，尝试让父视图获取子视图的相对框架，发现Button与子视图的排列顺序会影响onPreferenceChange的触发，以下是可复现的案例：

案例一：Button("TestingButton")在Text("TestingChild")上方 #

代码：

struct ContentView: View {
    var body: some View {
        VStack {

            Button("TestingButton") {}
            
            Text("TestingChild")
                .overlay {
                    GeometryReader { geo in
                        Color.clear
                            .preference(key: MyPreferenceKey.self, value: geo.frame(in: .named("Parent")))
                    }
                }
        }
        .coordinateSpace(.named("Parent"))
        .onPreferenceChange(MyPreferenceKey.self) {
            print("frame changed: \($0)") // 打印结果正确
        }
    }
}

结果：打印出正确的子视图相对父视图的框架信息

案例二：Button("TestingButton")在Text("TestingChild")下方 #

代码：

struct ContentView: View {
    var body: some View {
        VStack {
            
            Text("TestingChild")
                .overlay {
                    GeometryReader { geo in
                        Color.clear
                            .preference(key: MyPreferenceKey.self, value: geo.frame(in: .named("Parent")))
                    }
                }

            Button("TestingButton") {}
        }
        .coordinateSpace(.named("Parent"))
        .onPreferenceChange(MyPreferenceKey.self) {
            print("frame changed: \($0)") // 仅打印一次，为MyPreferenceKey的defaultValue
        }
    }
}

结果：仅打印一次，且输出的是MyPreferenceKey的默认值

成因分析 #

这个现象的核心在于SwiftUI的视图布局优先级与偏好值传递的时序逻辑：

1. Button的特殊布局特性：macOS上的默认SwiftUI Button会参与系统级的布局适配（比如动态类型、系统样式响应），其布局计算优先级高于普通Text视图。
2. 布局时序对偏好值的影响：
   • 当Button位于子视图上方时：VStack先完成Button的布局，父容器的尺寸已初步稳定，随后计算Text及其Overlay的布局。此时Parent坐标空间的边界已确定，GeometryReader能正确获取Text在父空间中的框架，偏好值正常向上传递，触发onPreferenceChange并输出正确结果。
   • 当Button位于子视图下方时：VStack先处理Text及其Overlay的布局，此时Button尚未完成布局，父容器的整体尺寸还未最终确定。GeometryReader获取的是临时、未稳定的框架，后续Button的布局会导致父容器尺寸调整，之前的子视图布局会被重新计算。而SwiftUI会丢弃布局未稳定阶段传递的偏好值，最终仅触发一次默认值的传递。
3. 偏好值传递的规则限制：SwiftUI的偏好值是在视图布局完成后向上传递的，若父容器因后续子视图布局发生尺寸变化，初始未稳定的偏好值传递会被系统忽略，最终仅保留默认值的触发。

环境信息 #

• Xcode版本：26.2
• Swift版本：Swift 6
• 部署目标：macOS 14+

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