横竖屏切换时ScrollView滚动位置适配及NavigationStack兼容问题

1. NavigationStack 改变了布局上下文与安全区域 #

NavigationStack自带的导航栏在横竖屏切换时高度会发生变化（iOS中竖屏约44pt，横屏通常降至32pt）。如果你的滚动位置是基于绝对像素偏移保存的，导航栏高度的变化会直接导致ScrollView的可滚动内容起始位置偏移，最终滚动位置和预期元素错位。

同时，NavigationStack会修改视图的安全区域insets，横竖屏切换时这些insets的变化会让ScrollView的实际可滚动区域尺寸计算出现偏差——如果原逻辑未考虑安全区域的动态调整，自然会失效。

2. 视图层级重构导致状态丢失或同步延迟 #

嵌入NavigationStack后，横竖屏切换时SwiftUI可能会重新构建NavigationStack内部的视图层级（尤其是ScrollView作为直接子视图或嵌套在动态视图中时）。如果用@State保存滚动位置，视图重新初始化会导致状态被重置；就算状态没丢失，也可能因为状态更新时机晚于ScrollView的布局刷新，导致滚动位置未被正确恢复。

另外，ScrollViewReader的scrollTo(_:anchor:)方法在NavigationStack环境下，可能因为元素id的隐式变化、或者锚点计算未适配新布局上下文，导致滚动到错误位置。

3. NavigationStack 干扰了滚动偏好值的传递与计算 #

如果原实现依赖PreferenceKey捕获滚动偏移，NavigationStack会在视图层级注入额外环境值，可能打断偏好值的传递路径，或者让计算出的偏移量包含了NavigationStack自身的布局偏移，最终恢复滚动位置时出现偏差。

假设你原本用ScrollViewReader+元素id来维护滚动位置，可做以下调整：

1. 基于元素id而非绝对偏移恢复位置 #

始终通过稳定的元素id调用scrollTo，避免依赖像素偏移：

struct ContentView: View {
    let items = Array(1...100).map { "Item \($0)" }
    @State private var topVisibleItemId: String?

    var body: some View {
        NavigationStack {
            ScrollViewReader { proxy in
                ScrollView {
                    LazyVStack {
                        ForEach(items, id: \.self) { item in
                            Text(item)
                                .id(item)
                                .frame(maxWidth: .infinity)
                                .padding()
                                .background(Color.gray.opacity(0.2))
                        }
                    }
                }
                // 横竖屏切换后延迟恢复位置，适配布局刷新
                .onChange(of: UIDevice.current.orientation) { _ in
                    DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
                        if let id = topVisibleItemId {
                            proxy.scrollTo(id, anchor: .top)
                        }
                    }
                }
                // 捕获当前可见的顶部元素id
                .overlay(
                    GeometryReader { geo in
                        Color.clear
                            .preference(key: TopVisibleItemKey.self, value: findTopVisibleItem(in: geo, proxy: proxy))
                    }
                )
                .onPreferenceChange(TopVisibleItemKey.self) { id in
                    topVisibleItemId = id
                }
                .navigationTitle("Scroll Test")
            }
        }
    }

    private func findTopVisibleItem(in geo: GeometryProxy, proxy: ScrollViewProxy) -> String? {
        // 遍历元素，找到可见区域顶部的元素id（留出误差空间）
        for item in items {
            guard let frame = proxy.frame(for: item) else { continue }
            let relativeFrame = geo.convert(frame, from: .global)
            if relativeFrame.minY <= geo.safeAreaInsets.top + 10 {
                return item
            }
        }
        return nil
    }
}

struct TopVisibleItemKey: PreferenceKey {
    static var defaultValue: String? = nil
    static func reduce(value: inout String?, nextValue: () -> String?) {
        value = value ?? nextValue()
    }
}

2. 适配安全区域变化 #

用@Environment(\.safeAreaInsets)获取顶部安全区域高度，在计算滚动位置时抵消其影响：

@Environment(\.safeAreaInsets) private var safeAreaInsets

// 在捕获滚动偏移时，减去顶部安全区域高度
let adjustedOffset = rawScrollOffset - safeAreaInsets.top

3. 用StateObject保留状态 #

如果@State导致状态丢失，改用@StateObject维护滚动位置，确保视图重构时状态不重置：

class ScrollPositionStore: ObservableObject {
    @Published var topVisibleItemId: String?
}

struct ContentView: View {
    @StateObject private var scrollStore = ScrollPositionStore()
    // ... 其他代码
}

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