Toolbar中NavigationLink初始化器结果未使用的技术咨询

问题原因 #

在SwiftUI的Toolbar中直接使用传统NavigationLink初始化器时，编译器会抛出“NavigationLink<Label, Destination>初始化器的结果未被使用”的警告。这是因为iOS 16+的NavigationStack架构下，这种直接声明的NavigationLink需要配合导航状态绑定或navigationDestination来关联目标视图，否则编译器会判定该链接的实例未被纳入有效导航逻辑。

解决方案 #

以下两种修复方式可根据你的导航架构选择：

方式1：使用带绑定的NavigationLink（兼容NavigationStack/NavigationView） #

通过tag和selection绑定将导航状态交由父视图管理，明确导航逻辑：

// 父视图中定义导航状态变量
@State private var selectedDestination: String? = nil

var body: some View {
    NavigationStack {
        Text("主视图内容")
            .toolbar {
                ToolbarItem(placement: .topBarLeading) {
                    NavigationLink(
                        destination: ThirdSubView(),
                        tag: "third",
                        selection: $selectedDestination,
                        label: {
                            Image(systemName: "person")
                        }
                    )
                }
                ToolbarItem(placement: .topBarTrailing) {
                    NavigationLink(
                        destination: SecondSubView(),
                        tag: "second",
                        selection: $selectedDestination,
                        label: {
                            Image(systemName: "gear")
                        }
                    )
                }
            }
    }
}

方式2：用Button+navigationDestination（推荐iOS16+） #

用普通Button触发导航状态变化，再通过navigationDestination关联目标视图，更贴合现代SwiftUI导航逻辑：

@State private var showThirdView = false
@State private var showSecondView = false

var body: some View {
    NavigationStack {
        Text("主视图内容")
            .toolbar {
                ToolbarItem(placement: .topBarLeading) {
                    Button {
                        showThirdView = true
                    } label: {
                        Image(systemName: "person")
                    }
                }
                ToolbarItem(placement: .topBarTrailing) {
                    Button {
                        showSecondView = true
                    } label: {
                        Image(systemName: "gear")
                    }
                }
            }
            // 绑定目标视图
            .navigationDestination(isPresented: $showThirdView) {
                ThirdSubView()
            }
            .navigationDestination(isPresented: $showSecondView) {
                SecondSubView()
            }
    }
}

原代码报错的核心原因 #

无绑定/无tag的旧版NavigationLink初始化器在Toolbar中时，编译器无法确认该链接是否与导航栈逻辑关联，因此抛出“初始化器结果未被使用”的警告。上述两种方式都明确了导航状态的管理路径，让编译器识别到导航行为的有效性。

内容的提问来源于stack exchange，提问作者권정근