SwiftUI：如何禁用从详情页返回列表时自动滚动至顶部

核心原因 #

问题出在两个关键点：一是从详情页返回时，onAppear里的getUniqueWords()会重新加载数据，导致uniqueWords被重新赋值，列表完全重建后自动滚动到顶部；二是默认NavigationStack不会自动保存列表的滚动位置，需要手动处理。

解决方案 #

1. 先避免重复加载数据

修改onAppear的逻辑，只在数据为空时执行加载操作，防止列表频繁重建：

.onAppear {
    if uniqueWords.isEmpty {
        getUniqueWords()
    }
}

2. 保存并恢复滚动位置

使用ScrollViewReader跟踪滚动位置，结合状态变量保存选中的单词ID，返回时自动滚动到对应位置：

// 定义状态变量存储选中的单词ID
@State private var selectedWord: String?

NavigationStack {
    ScrollViewReader { proxy in
        List {
            ForEach(uniqueWords.sorted(), id: \.self) { unique in
                NavigationLink(destination: WordDetailView(listing: unique)) {
                    HStack {
                        ListingItemView(listing: unique)
                    }
                }
                // 给每个列表项绑定唯一ID，用于滚动定位
                .id(unique)
                // 点击列表项时保存当前单词ID
                .onTapGesture {
                    selectedWord = unique
                }
            }
        }
        .onAppear {
            if uniqueWords.isEmpty {
                getUniqueWords()
            }
            // 数据加载完成后，若有保存的ID则滚动到对应位置
            if let word = selectedWord {
                proxy.scrollTo(word, anchor: .top)
            }
        }
    }
}

3. 进阶：持久化滚动位置

如果希望App重启后仍能记住滚动位置，可以把状态变量换成@AppStorage实现本地持久化：

@AppStorage("selectedWord") private var selectedWord: String?

关键说明 #

• ScrollViewReader是SwiftUI 3.0+的API，可直接控制滚动视图的定位；
• 给每个列表项绑定.id(unique)是准确定位的核心，确保滚动目标唯一；
• 阻止重复刷新数据源是解决滚动重置的前提，否则后续的位置恢复会失效。

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