SwiftUI中NavigationStack结合List路由异常：点击一项添加全部栈项

1. List的视图复用机制引发闭包捕获异常 #

SwiftUI的List会复用列表单元格视图来优化性能，而ScrollView是直接渲染所有子视图，不存在复用逻辑。如果你的点击回调（比如onTapGesture）或NavigationLink的触发逻辑中，没有显式固定当前列表项的引用，而是直接使用循环中的变量（比如for item in items里的item），视图复用会导致闭包捕获到复用后的新项引用，或者多个复用视图共享同一个闭包实例，最终点击一次就触发多次路由添加操作。

错误示例：

List(items) { item in
    DummyListItem(item: item)
        .onTapGesture {
            // 因List复用，item可能被后续项覆盖，导致多次添加路由
            viewModel.routes.append(.detail(item))
        }
}

2. NavigationLink的错误使用方式 #

如果你的NavigationLink没有通过tag和selection绑定当前项的唯一标识，而是直接在destination的初始化闭包里执行路由添加，List的视图复用可能会导致多个NavigationLink被错误激活。因为destination闭包可能在视图复用过程中被多次调用，进而重复添加路由。

错误示例：

List(items) { item in
    NavigationLink(destination: {
        viewModel.routes.append(.detail(item))
        DetailView(item: item)
    }, label: {
        DummyListItem(item: item)
    })
}

3. 状态更新触发重复执行添加逻辑 #

如果路由添加逻辑没有严格限制在用户点击动作中，而是放在视图body或onAppear等会重复调用的代码块里，当ObservedObject的状态更新（比如路由栈变化）触发List重绘时，会再次执行添加逻辑，导致多个项被加入路由栈。而ScrollView因不复用视图，重绘时不会重复触发这些逻辑。

• 显式用let捕获循环中的当前项，避免闭包引用可变的循环变量：

  List(items) { let item in
      DummyListItem(item: item)
          .onTapGesture {
              viewModel.routes.append(.detail(item))
          }
  }
  

• 使用NavigationLink的selection绑定方式控制路由，替代直接在回调中添加：

  @State private var selectedItem: Item?
  
  List(items) { item in
      NavigationLink(
          tag: item,
          selection: $selectedItem,
          destination: { DetailView(item: item) },
          label: { DummyListItem(item: item) }
      )
  }
  .onChange(of: selectedItem) { newItem in
      if let item = newItem {
          viewModel.routes.append(.detail(item))
          selectedItem = nil // 可根据路由逻辑调整是否清空
      }
  }
  

• 确保路由添加逻辑仅在用户点击时执行，避免将其放在视图构建、生命周期回调等会重复执行的代码中。

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