SwiftUI中如何结合Button与.navigationDestination实现复杂导航？

我正在开发一个设置页面，包含约10个按钮。因自定义设计需求，这些按钮均未置于ForEach或List中，且每个按钮需导航至不同视图并传递独特变量。此前我会使用NavigationLink(destination:label)实现导航，该方法虽仍可用，但我遇到了问题：部分视图中需使用的NavigationLink(isPresented)已被弃用。

我发现.navigationDestination可能是更好的替代方案，但无法使其按预期工作——比如在NavigationLink子视图中使用时，无法以编程方式关闭视图。网上多数SwiftUI教程及资源演示的是基于List和ForEach结合程序化数据的导航，而非我这种简单按钮点击场景。查了大量视频及Apple文档，仍无法理解这类新导航的用法。

想请教：

• 这种场景下如何正确使用.navigationDestination，它有哪些要求？
• 怎么把它与Button(action:label)结合实现导航？
• 它在NavigationLink子视图中的表现是怎样的？

以下是我尝试的简化示例：
第一视图：

NavigationStack() {
    NavigationLink(label: {
        Text("Navigate To Second View")
    }, destination: {
        SecondView()
    })
}

第二视图：

Button(action: {
    isPresented = true // 跳转到第三视图
}) {
    Text("Navigate to third view")
}
.navigationDestination(isPresented: $isPresented, destination: ThirdView())

第三视图：

Button(action: {
    isPresented = false // 返回第二视图，但这个操作无效
}) {
    Text("Navigate Back to second view")
}

核心要点：.navigationDestination的正确用法 #

.navigationDestination必须附加到NavigationStack或其内部的父视图上，而非深层子视图。它的作用是给NavigationStack注册导航规则：当某个触发条件满足时，应该跳转到哪个视图。

1. 结合Button实现导航的最优方式：用navigationPath管理栈 #

通过绑定NavigationStack的path数组来管理导航流程，这是最灵活的方案，既支持按钮点击触发，也能轻松传递自定义变量。

改造后的完整示例：

第一视图（根视图）：

struct FirstView: View {
    // 用枚举定义所有导航目标，支持带关联值传递变量
    enum NavigationTarget {
        case secondView
        case thirdView(userName: String) // 示例：传递字符串变量
    }
    
    // 管理导航栈的数组
    @State private var navigationPath = [NavigationTarget]()
    
    var body: some View {
        NavigationStack(path: $navigationPath) {
            Button(action: {
                // 向栈中添加目标，触发导航
                navigationPath.append(.secondView)
            }) {
                Text("跳转到第二视图")
            }
            
            // 统一注册所有导航目标的跳转规则
            .navigationDestination(for: NavigationTarget.self) { target in
                switch target {
                case .secondView:
                    SecondView(navigationPath: $navigationPath)
                case .thirdView(let userName):
                    ThirdView(userName: userName, navigationPath: $navigationPath)
                }
            }
        }
    }
}

第二视图：

struct SecondView: View {
    // 接收根视图的导航栈绑定
    @Binding var navigationPath: [FirstView.NavigationTarget]
    
    var body: some View {
        Button(action: {
            // 跳转到第三视图并传递变量
            navigationPath.append(.thirdView(userName: "Etienne"))
        }) {
            Text("跳转到第三视图")
        }
    }
}

第三视图：

struct ThirdView: View {
    let userName: String
    @Binding var navigationPath: [FirstView.NavigationTarget]
    
    var body: some View {
        VStack {
            Text("欢迎，\(userName)")
            Button(action: {
                // 移除栈顶元素，返回上一级视图
                navigationPath.removeLast()
                // 若要直接返回根视图，用 navigationPath.removeAll()
            }) {
                Text("返回第二视图")
            }
        }
    }
}

2. 基于isPresented绑定的替代方案 #

如果习惯用isPresented触发导航，需注意把.navigationDestination注册在NavigationStack范围内，而非子视图内部。

示例：

第一视图：

struct FirstView: View {
    @State private var showSecondView = false
    @State private var showThirdView = false
    
    var body: some View {
        NavigationStack {
            Button(action: {
                showSecondView = true
            }) {
                Text("跳转到第二视图")
            }
            // 注册第二视图的导航规则
            .navigationDestination(isPresented: $showSecondView) {
                SecondView(showThirdView: $showThirdView)
            }
            // 注册第三视图的导航规则
            .navigationDestination(isPresented: $showThirdView) {
                ThirdView()
            }
        }
    }
}

第二视图：

struct SecondView: View {
    @Binding var showThirdView: Bool
    
    var body: some View {
        Button(action: {
            showThirdView = true
        }) {
            Text("跳转到第三视图")
        }
    }
}

第三视图：

struct ThirdView: View {
    // 用环境变量获取系统自带的返回动作
    @Environment(\.dismiss) private var dismiss
    
    var body: some View {
        Button(action: {
            dismiss()
        }) {
            Text("返回第二视图")
        }
    }
}

关键注意事项 #

• .navigationDestination必须在NavigationStack的作用域内注册，深层子视图中的注册会被忽略，导致导航失效。
• 编程式返回优先使用@Environment(\.dismiss)或修改navigationPath，避免在子视图中直接修改父视图的isPresented绑定（除非绑定是显式传递的，但dismiss更简洁）。
• 用带关联值的枚举管理navigationPath，可以清晰区分不同导航场景，同时无缝传递各种类型的变量。

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