SwiftUI新NavigationStack警告：已指定类型仍提示未找到navigationDestination

我用新API编写了如下最小复现代码：

struct ListViewWithNewAPI: View {
  @State var selectedString: String? = nil
  
  var body: some View {
    let details = ["foo", "bar", "baz"]
    
    NavigationStack {
      List {
        ForEach(details, id: \.self) { detail in
          NavigationLink(detail, value: detail)
        }
      }
      .navigationDestination(item: $selectedString) { detail in
        Text("This is a detailed page for \(detail)")
          .navigationTitle("Detail page")
      }
      .navigationTitle("List page")
    }
  }
}

点击链接时出现如下警告：

A NavigationLink is presenting a value of type “String” but there is no matching navigationDestination declaration visible from the location of the link. The link cannot be activated.

我明明已经添加了对应String类型的navigationDestination，为什么会出现这个警告？

补充：旧写法如下（该API已弃用，但当时可正常工作，无需手动设置$selectedString）：

List {
      ForEach(details, id: \.self) { detail in
        let destination = Text("This is a detailed page for \(detail)")
          .navigationTitle("Detail page")
        
        NavigationLink(
          detail,
          destination: destination,
          tag: detail,
          selection: $selectedString)
      }
    }

问题原因 #

问题出在**navigationDestination的绑定参数$selectedString**上。新的NavigationStack+navigationDestination API设计中，两种用法是互斥的：

• NavigationLink(value:)需要匹配不带绑定参数的navigationDestination(for:)（仅指定类型），由系统自动处理导航跳转
• 带绑定的navigationDestination(item:)是用来配合带selection参数的NavigationLink，实现手动控制导航状态的逻辑

你的代码混用了两种模式，导致系统找不到NavigationLink(value:)对应的目标声明，因此抛出警告。

解决方案 #

方案一：使用无绑定的导航目标声明 #

移除navigationDestination的item:绑定，改用for:指定类型，让NavigationLink(value:)自动匹配：

struct ListViewWithNewAPI: View {
  var body: some View {
    let details = ["foo", "bar", "baz"]
    
    NavigationStack {
      List {
        ForEach(details, id: \.self) { detail in
          NavigationLink(detail, value: detail)
        }
      }
      .navigationDestination(for: String.self) { detail in
        Text("This is a detailed page for \(detail)")
          .navigationTitle("Detail page")
      }
      .navigationTitle("List page")
    }
  }
}

方案二：保留绑定逻辑（类似旧API） #

如果需要通过$selectedString手动控制导航状态，改用带tag和selection参数的NavigationLink，此时可以选择直接在Link中定义目标视图，或者保留带绑定的navigationDestination：

struct ListViewWithNewAPI: View {
  @State var selectedString: String? = nil
  
  var body: some View {
    let details = ["foo", "bar", "baz"]
    
    NavigationStack {
      List {
        ForEach(details, id: \.self) { detail in
          NavigationLink(detail, tag: detail, selection: $selectedString) {
            Text("This is a detailed page for \(detail)")
              .navigationTitle("Detail page")
          }
        }
      }
      // 也可以保留以下代码替代Link中的目标视图，效果一致
      // .navigationDestination(item: $selectedString) { detail in
      //   Text("This is a detailed page for \(detail)")
      //     .navigationTitle("Detail page")
      // }
      .navigationTitle("List page")
    }
  }
}

新旧API核心差异 #

旧API中NavigationLink的destination、tag、selection是强绑定的，系统自动关联选择值与目标页面。新API则将导航逻辑解耦：

• 无绑定的navigationDestination(for:)配合NavigationLink(value:)：适合自动导航场景，无需手动维护状态
• 带绑定的navigationDestination(item:)配合NavigationLink(tag:selection:)：适合需要主动控制导航状态（比如从外部触发跳转）的场景

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