Toolbar按钮内的NavigationLink无法跳转，求问题排查与解决方法

问题原因 #

你不是不能在Toolbar里使用NavigationLink，而是用错了方式——NavigationLink是SwiftUI视图，必须作为视图层级的一部分存在，但你把它放在了Button的动作闭包（{}）里，这个闭包是用来执行点击后的代码逻辑，不是用来添加视图的，所以自然不会触发跳转。

解决方案 #

根据你的iOS版本，有几种可行的实现方式：

方式一：直接将NavigationLink作为Toolbar项（最简单） #

如果不需要Button的额外逻辑（比如点击前的校验），可以直接把NavigationLink放在ToolbarItemGroup里，它本身就可以作为可点击的按钮：

VStack {
    NavigationView {
        List {
            // 列表内容
        }
        .toolbar {
            ToolbarItemGroup(placement: .navigationBarTrailing) {
                NavigationLink(destination: ContentView()) {
                    Text("MyButton")
                }
            }
        }
    }
}

方式二：iOS 16+ 使用NavigationStack的路径绑定 #

iOS16及以上推荐使用NavigationStack替代NavigationView，通过绑定路径数组来控制跳转：

struct MainView: View {
    @State private var navPath = NavigationPath()
    
    var body: some View {
        NavigationStack(path: $navPath) {
            List {
                // 列表内容
            }
            .toolbar {
                ToolbarItemGroup(placement: .navigationBarTrailing) {
                    Button("MyButton") {
                        // 往路径中添加标识，触发对应跳转
                        navPath.append("TargetView")
                    }
                }
            }
            // 配置路径对应的目标视图
            .navigationDestination(for: String.self) { pathValue in
                if pathValue == "TargetView" {
                    ContentView() // 你的目标视图
                }
            }
        }
    }
}

方式三：iOS 15及以下 使用NavigationView的激活状态绑定 #

对于iOS15及更早版本，用@State变量控制隐藏的NavigationLink的激活状态：

struct MainView: View {
    @State private var shouldNavigate = false
    
    var body: some View {
        NavigationView {
            List {
                // 隐藏的NavigationLink，通过状态控制激活
                NavigationLink(destination: ContentView(), isActive: $shouldNavigate) {
                    EmptyView()
                }
                .hidden()
                
                // 列表原有内容
            }
            .toolbar {
                ToolbarItemGroup(placement: .navigationBarTrailing) {
                    Button("MyButton") {
                        // 切换状态触发跳转
                        shouldNavigate = true
                    }
                }
            }
        }
    }
}

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