SwiftUI 跳转详情返回后如何保持ForEach列表的滚动位置

核心问题溯源 #

SwiftUI 中 List 的滚动位置状态是和组件实例强绑定的，只要从详情页返回路径上出现以下任意一种情况，滚动位置就会直接重置到顶部：

• 承载 List 的父视图在导航过程中被完全销毁，而非临时挂起隐藏
• 跳转前执行的前置逻辑，无意义刷新了全量列表数据源，触发 List 全量重绘
• 自定义 NavigationButton 的跳转状态被上提到父视图，状态变化时连带触发 List 重新初始化

分步调整实现 #

1. 解耦列表数据源与详情页加载逻辑 #

你当前点击条目时的前置回调里，调用的athlyticDataStore.loadDataForSelectedWorkout如果内部会重新拉取全量workoutMonths数据，就会直接打乱列表原有结构，触发 List 重置。
调整方式：

• 把详情页需要的加载逻辑单独拆分，仅更新详情页依赖的状态字段，不要触发全量列表的数据源刷新
• 保证workoutMonths数组里每个元素的ID是持久稳定的，不要每次刷新时生成临时随机ID，避免ForEach判断为全量列表更换
  调整后的点击回调示例：

action: {
    // 仅更新详情页需要的选中状态
    athlyticDataStore.selectedWorkout = workout
    // 拆分加载方法：只拉取当前选中锻炼的详情数据，不改动workoutMonths列表本身
    athlyticDataStore.loadDetailWorkoutData(for: workout)
    generator.notificationOccurred(.success)
}

2. 调整自定义NavigationButton的状态管理逻辑 #

不要把跳转激活状态上提到父视图层。如果你的NavigationButton当前实现是依赖父视图的@State变量控制跳转，那只要这个变量随导航流程变化，就会触发父视图的body重算，连带List被销毁重建。
调整要求：

• 让每个列表行对应的NavigationButton，单独持有自己的跳转激活状态，不依赖父视图的共享状态
• 保留现有LazyDestination的懒加载实现，避免在列表行渲染时就提前初始化详情页实例

3. 避免无意义视图切换触发List销毁 #

你当前VStack里的if workoutMonths.count == 0空状态判断，要保证整个导航跳转流程中判断结果不会变化。如果加载详情的逻辑临时改动了workoutMonths的计数，就会在“空状态文本”和“List”两个独立视图间切换，自然丢失滚动位置。

4. 兜底实现滚动位置记忆 #

如果完成以上调整后仍存在位置丢失，可以通过锚点持久化做兜底：

• 在列表视图层存储离开时最后浏览到的锻炼记录ID
• 监听列表滚动事件，实时更新存储的ID值
• 页面重新出现（也就是从详情页返回）时，自动滚动到之前记录的位置
  核心实现示例：

struct WorkoutListView: View {
    // 持久化存储离开时的浏览位置
    @State private var lastStayedWorkoutID: UUID?
    var body: some View {
        ScrollViewReader { scrollProxy in
            List {
                // 原有ForEach构建的月份分组、锻炼记录列表
            }
            // 页面重新显示时，自动恢复到之前的浏览位置
            .onAppear {
                guard let targetID = lastStayedWorkoutID else { return }
                scrollProxy.scrollTo(targetID, anchor: .top)
            }
            // 监听列表滚动，记录当前可见的锻炼记录ID
            .onPreferenceChange(VisibleWorkoutPreferenceKey.self) { visibleID in
                lastStayedWorkoutID = visibleID
            }
        }
    }
}

补充：如果项目最低适配版本是iOS 16+，List原生就支持自动保留滚动状态，只要满足“List组件不被销毁、数据源结构稳定”两个条件，不需要额外写手动锚点逻辑。

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