SwiftUI中LazyVGrid绑定onTapGesture跳转出现NavigationLink未使用警告问题

你遇到的跳转失败、编译警告，核心原因是错误地将NavigationLink实例放在了.onTapGesture的点击回调闭包中。
NavigationLink本身是一个需要被加入到视图层级中的视图组件，不是可以在点击事件里临时创建、直接就能触发跳转的工具类。在tap闭包里创建的NavigationLink没有被挂载到视图树上，SwiftUI检测到这个对象创建后没有被任何地方持有/使用，就会抛出「NavigationLink初始化结果未被使用」的警告，自然也完全无法触发页面跳转。

方案1：直接嵌套包装（最简便） #

把网格里的Cell直接作为NavigationLink的展示内容，让系统自动处理点击跳转，完全不需要额外写手势逻辑：

var body: some View {
    NavigationView {
        ScrollView {
            LazyVGrid(columns: gridItems, spacing: 16) {
                ForEach(viewModel.pokemon) { pokemon in
                    // 直接将Cell嵌套在NavigationLink内，替代原来的onTapGesture逻辑
                    NavigationLink(destination: PokemonDetailView(pokemon: pokemon)) {
                        PokemonCell(pokemon: pokemon, viewModel: viewModel)
                    }
                }
            }
        }
        .navigationTitle("Pokedex")
    }
}

这个方案的优势：

• 完全遵循SwiftUI导航组件的设计逻辑，不会触发编译警告
• 系统自动处理点击反馈、页面转场动画，不需要额外维护交互状态
• 和网格视图的懒加载机制完美适配，不会出现列表滚动时的导航状态混乱

方案2：支持自定义交互的程序化导航 #

如果你的点击逻辑需要额外做操作（比如跳转前埋点、条件判断、触发其他联动），可以用状态绑定的方式实现导航，不要在tap里临时创建NavigationLink：

1. 首先在视图结构体中新增选中状态的绑定属性：

@State private var selectedPokemon: Pokemon?

2. 修改视图结构，通过状态绑定驱动导航跳转：

var body: some View {
    NavigationView {
        ScrollView {
            LazyVGrid(columns: gridItems, spacing: 16) {
                ForEach(viewModel.pokemon) { pokemon in
                    PokemonCell(pokemon: pokemon, viewModel: viewModel)
                        .onTapGesture {
                            // 点击时更新选中值，即可触发绑定的导航
                            selectedPokemon = pokemon
                        }
                }
            }
        }
        .navigationTitle("Pokedex")
        // 绑定选中状态的隐藏导航Link，统一负责跳转逻辑，不占用网格布局
        .background(
            NavigationLink(
                destination: PokemonDetailView(pokemon: selectedPokemon!),
                tag: selectedPokemon,
                selection: $selectedPokemon
            ) {
                EmptyView()
            }
            .hidden()
        )
    }
}

• 永远不要在手势、点击回调的闭包里临时创建NavigationLink，所有导航相关的Link实例都必须是视图层级的正式组成部分
• 上述实现兼容iOS13到iOS15的全版本NavigationView逻辑，如果你的项目适配iOS16+，可以直接替换为NavigationStack的值绑定导航写法，状态管理会更简洁

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