SwiftUI中TabView内嵌子页面设置toolbar按钮不显示问题求解

问题成因 #

你当前的视图层级为 NavigationView -> TabView -> TestView1/TestView2，SwiftUI中toolbar修饰符的生效规则为：仅附加到NavigationView直接管理的导航栈层级视图上的配置会被识别。
TabView作为NavigationView的直接子视图，抢占了导航上下文的响应权，它的子视图（TestView1/TestView2）的toolbar配置不会被外层NavigationView捕获，仅navigationTitle支持向下透传生效，这就是标题正常显示、工具栏按钮不显示的根本原因。

解决方案 #

方案一（推荐）：每个Tab持有独立导航栈 #

这是最符合SwiftUI设计规范的方案，语义上每个Tab的导航栈本就应该独立、互不干扰，修改后TestView1的toolbar可以直接在内部生效，不需要修改原有TestView1的代码：

1. 移除TestView外层包裹的NavigationView：

struct TestView: View {
    var body: some View {
        TabTestView()
    }
}

2. 给TabView的每个子项单独包裹NavigationStack（iOS16+，如果需要兼容iOS15及更早版本替换为NavigationView即可）：

struct TabTestView: View {
    var body: some View {
        TabView {
            NavigationStack {
                TestView1()
            }
            .tabItem {
                Label("Test 1", systemImage: "list.dash")
            }
            
            NavigationStack {
                TestView2()
            }
            .tabItem {
                Label("Test 2", systemImage: "plus")
            }
        }
    }
}

该方案下toolbar完全归属TestView1管理，点击逻辑可以直接使用TestView1的内部变量，耦合度最低。

方案二（仅特殊场景使用）：共用导航栈时通过状态绑定控制 #

如果你确实需要所有Tab共用同一个外层NavigationView，可以通过监听当前选中Tab、绑定点击回调的方式实现：

1. 给TabTestView添加选中状态和回调绑定：

struct TabTestView: View {
    @State private var selectedTab = 0
    @State private var test1SaveAction: (() -> Void)?
    
    var body: some View {
        TabView(selection: $selectedTab) {
            TestView1(saveAction: $test1SaveAction)
                .tag(0)
                .tabItem {
                    Label("Test 1", systemImage: "list.dash")
                }
            TestView2()
                .tag(1)
                .tabItem {
                    Label("Test 2", systemImage: "plus")
                }
        }
        .toolbar {
            if selectedTab == 0 {
                ToolbarItem(placement: .navigationBarTrailing) {
                    Button("Save") {
                        test1SaveAction?()
                    }
                }
            }
        }
    }
}

2. 在TestView1中给绑定的回调赋值内部逻辑：

struct TestView1: View {
    @Binding var saveAction: (() -> Void)?
    // 示例内部依赖变量
    @State private var inputContent = ""
    
    var body: some View {
        Text("Hello World")
            .navigationTitle("Test View 1")
            .onAppear {
                saveAction = {
                    // 执行TestView1内部的保存逻辑，可直接访问内部变量
                    print("保存操作，当前内容：\(inputContent)")
                }
            }
            .onDisappear {
                saveAction = nil
            }
    }
}

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