SwiftUI中如何保存ScrollView精确滚动位置至App Storage？

当然可以实现，不管使用LazyVStack还是普通VStack，核心是通过滚动位置绑定或自定义监听来记录精确偏移，并将数据持久化到AppStorage。你之前用项目ID失败，大概率是因为LazyVStack的懒加载特性，仅靠ID无法还原动态高度列表的精确滚动位置，下面分两种场景给出解决方案：

场景1：iOS 17+ 固定/动态高度列表（最简方案） #

iOS 17新增了scrollPosition(offset:) API，可以直接绑定滚动偏移量到AppStorage变量，无需额外处理，对LazyVStack完全兼容：

struct PersistentScrollView: View {
    // 用AppStorage持久化滚动偏移量
    @AppStorage("scrollViewOffset") private var scrollOffset: CGFloat = 0
    // 模拟列表数据
    let items = Array(0...100)
    
    var body: some View {
        ScrollView {
            LazyVStack(spacing: 8) {
                ForEach(items, id: \.self) { item in
                    Text("列表项 \(item)")
                        .frame(height: 50)
                        .frame(maxWidth: .infinity)
                        .background(Color.gray.opacity(0.2))
                }
            }
        }
        // 直接绑定滚动偏移到AppStorage变量
        .scrollPosition(offset: $scrollOffset)
        .onAppear {
            // 视图加载后触发位置恢复
            scrollOffset = scrollOffset
        }
    }
}

场景2：iOS 16及以下 动态高度列表（兼容方案） #

如果需要适配低版本系统，需要结合ScrollViewReader和自定义PreferenceKey来监听滚动偏移，同时记录目标元素ID和相对偏移，确保精确恢复：

struct LegacyPersistentScrollView: View {
    @AppStorage("topVisibleItemID") private var topItemID: Int?
    @AppStorage("relativeScrollOffset") private var relativeOffset: CGFloat = 0
    let items = Array(0...100).map { "这是动态高度的列表项 \($0)，内容长度不固定，可能换行" }
    
    var body: some View {
        ScrollViewReader { proxy in
            ScrollView {
                LazyVStack(spacing: 12) {
                    ForEach(Array(items.enumerated()), id: \.offset) { index, content in
                        Text(content)
                            .padding()
                            .frame(maxWidth: .infinity)
                            .background(Color.gray.opacity(0.2))
                            .id(index) // 给每个元素标记唯一ID
                    }
                }
                // 监听滚动偏移变化
                .onScrollOffsetChanged { offset in
                    let contentOffset = -offset.y
                    // 获取当前顶部可见的元素ID
                    if let visibleID = proxy.index(in: CGRect(origin: offset, size: UIScreen.main.bounds.size), for: .top) {
                        topItemID = visibleID
                        // 计算相对于该元素顶部的偏移量
                        if let itemFrame = proxy.frame(for: visibleID) {
                            relativeOffset = contentOffset - itemFrame.minY
                        }
                    }
                }
            }
            .onAppear {
                guard let targetID = topItemID else { return }
                // 先滚动到目标元素顶部
                proxy.scrollTo(targetID, anchor: .top)
                // 延迟调整相对偏移，确保视图渲染完成
                DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
                    proxy.scrollBy(x: 0, y: -relativeOffset)
                }
            }
        }
    }
}

// 自定义PreferenceKey用于获取滚动偏移
private struct ScrollOffsetKey: PreferenceKey {
    static var defaultValue: CGPoint = .zero
    static func reduce(value: inout CGPoint, nextValue: () -> CGPoint) {}
}

// 扩展View添加滚动偏移监听方法
private extension View {
    func onScrollOffsetChanged(action: @escaping (CGPoint) -> Void) -> some View {
        self.background(
            GeometryReader { geo in
                Color.clear
                    .preference(key: ScrollOffsetKey.self, value: geo.frame(in: .named("scrollSpace")).origin)
            }
        )
        .coordinateSpace(name: "scrollSpace")
        .onPreferenceChange(ScrollOffsetKey.self, perform: action)
    }
}

关键说明 #

• 仅用元素ID无法还原精确位置的原因：LazyVStack懒加载未渲染的元素，直接scrollTo(id)只能定位到元素顶部，无法恢复到元素中间的滚动位置；如果元素高度动态变化，ID对应的位置也会发生偏移。
• 持久化逻辑：AppStorage会自动将数据保存到用户默认设置，即使关闭应用或切换视图，数据也不会丢失。

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