SwiftUI NavigationView数据源加载完成后自动pop问题求解

NavigationView自动pop的核心原因是导航状态绑定的标识失效：

• 当前列表用\.self作为元素的唯一标识符，当数据源的元素值发生变更时，SwiftUI的Diff算法会判定旧元素被删除、新元素被插入，对应的列表行和绑定的NavigationLink都会被销毁重建。
• 跳转时激活的是旧元素对应的NavigationLink，该对象被销毁后，激活状态自动失效，NavigationView就会触发默认的pop逻辑回到上一级页面。

下面提供3种兼容不同版本的解决思路：

方案1：使用稳定的唯一ID（推荐，兼容所有iOS版本） #

不要直接用元素的值作为唯一标识，改为给数据模型添加固定不变的id属性，确保数据源的value更新时，元素的唯一标识不会变化：

// 自定义带稳定ID的模型
struct Item: Identifiable {
    let id = UUID()
    var value: Int
}

class ViewModel: ObservableObject {
  @Published private(set) var dataSource = [Item(value:1), Item(value:2), Item(value:3), Item(value:4), Item(value:5)]
  
  init() {
    DispatchQueue.main.asyncAfter(deadline: .now() + 3) {
      // 只更新value，id保持不变
      self.dataSource[0].value = 99
    }
  }
}

struct ContentView: View {
  @ObservedObject var viewModel = ViewModel()
  
  var body: some View {
    NavigationView {
      List(viewModel.dataSource) { item in
        NavigationLink(destination: Text("\(item.value)")) {
          Text("\(item.value)")
            .padding()
        }
      }
    }
  }
}

方案2：手动管理导航激活状态 #

用NavigationLink的isActive参数单独绑定导航状态，不与列表元素的生命周期绑定：

struct ContentView: View {
  @ObservedObject var viewModel = ViewModel()
  @State private var navIsActive = false
  @State private var selectedItem: Int?
  
  var body: some View {
    NavigationView {
      List(viewModel.dataSource, id: \.self) { item in
        Button {
          selectedItem = item
          navIsActive = true
        } label: {
          Text("\(item)")
            .padding()
        }
      }
      // 全局挂载NavigationLink，不受列表刷新影响
      .background(
        NavigationLink(isActive: $navIsActive) {
          if let selectedItem = selectedItem {
            Text("\(selectedItem)")
          }
        } label: {
          EmptyView()
        }
      )
    }
  }
}

方案3：适配iOS 16+ 使用NavigationStack #

废弃NavigationView改用NavigationStack，单独用路径数组管理导航状态，完全和列表数据源解耦：

struct ContentView: View {
  @ObservedObject var viewModel = ViewModel()
  @State private var navPath = [Int]()
  
  var body: some View {
    NavigationStack(path: $navPath) {
      List(viewModel.dataSource, id: \.self) { item in
        Button {
          navPath.append(item)
        } label: {
          Text("\(item)")
            .padding()
        }
      }
      .navigationDestination(for: Int.self) { item in
        Text("\(item)")
      }
    }
  }
}

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