SwiftUI中TabView搭配NavigationSplitView时MacOS工具栏重复问题求助

方案1：精准指定工具栏放置位置 #

macOS的Toolbar渲染逻辑和iOS不同，默认会叠加所有标签页内的工具栏组件。可以通过ToolbarItemGroup搭配专属的ToolbarItemPlacement，让每个标签页的工具栏只绑定到当前激活的NavigationSplitView场景：

struct TabContent: View {
    var body: some View {
        NavigationSplitView {
            SidebarView()
                .toolbar {
                    ToolbarItemGroup(placement: .navigation) {
                        // 侧边栏工具栏内容
                    }
                }
        } content: {
            ContentView()
                .toolbar {
                    ToolbarItemGroup(placement: .primaryAction) {
                        // 内容栏工具栏内容
                    }
                }
        } detail: {
            DetailView()
                .toolbar {
                    ToolbarItemGroup(placement: .automatic) {
                        // 详情栏工具栏内容
                    }
                }
        }
    }
}

指定不同的placement能让系统识别不同工具栏的归属，避免无差别叠加。

方案2：通过场景状态控制工具栏渲染 #

利用@Environment(\.scenePhase)监听标签页的激活状态，仅在当前标签页处于激活状态时渲染工具栏：

struct TabContent: View {
    @Environment(\.scenePhase) private var scenePhase
    
    var body: some View {
        NavigationSplitView {
            SidebarView()
                .toolbar {
                    if scenePhase == .active {
                        // 侧边栏工具栏内容
                    }
                }
        } content: {
            ContentView()
                .toolbar {
                    if scenePhase == .active {
                        // 内容栏工具栏内容
                    }
                }
        } detail: {
            DetailView()
                .toolbar {
                    if scenePhase == .active {
                        // 详情栏工具栏内容
                    }
                }
        }
    }
}

切换标签页时，非激活标签页的场景状态变为.inactive，对应的工具栏会自动隐藏，从根源避免叠加。

方案3：将工具栏提升到TabView层级统一管理 #

放弃在每个NavigationSplitView列内单独设置工具栏，转而在TabView外层统一管理工具栏内容，根据当前选中的标签页动态切换：

struct MainView: View {
    @State private var selectedTab = 0
    
    var body: some View {
        NavigationStack {
            TabView(selection: $selectedTab) {
                TabContent1()
                    .tag(0)
                TabContent2()
                    .tag(1)
            }
            .toolbar {
                switch selectedTab {
                case 0:
                    ToolbarItemGroup(placement: .navigation) { /* 侧边栏项 */ }
                    ToolbarItemGroup(placement: .primaryAction) { /* 内容栏项 */ }
                case 1:
                    ToolbarItem(placement: .automatic) { /* 对应项 */ }
                default:
                    EmptyView()
                }
            }
        }
    }
}

这种方式让系统只渲染一个全局工具栏，切换标签时仅更新内容，彻底解决叠加问题。

方案4：结合AppKit手动管理窗口工具栏 #

如果SwiftUI原生方法不足以满足需求，可以直接操作AppKit的NSWindow API，在切换标签时手动清理并重置工具栏：

struct MainView: View {
    @State private var selectedTab = 0
    
    var body: some View {
        TabView(selection: $selectedTab) {
            TabContent1()
                .tag(0)
            TabContent2()
                .tag(1)
        }
        .onChange(of: selectedTab) { _ in
            guard let window = NSApplication.shared.windows.first(where: { $0.isKeyWindow }) else { return }
            // 清空现有工具栏项
            window.toolbar?.items.removeAll()
            // 添加当前标签页对应的工具栏项
            let newItem = NSToolbarItem(itemIdentifier: .init("customItem"))
            newItem.label = "操作"
            newItem.toolTip = "执行对应操作"
            newItem.image = NSImage(systemSymbolName: "gear", accessibilityDescription: nil)
            window.toolbar?.items.append(newItem)
        }
    }
}

这种方法适合复杂的定制化场景，但需要注意AppKit和SwiftUI的生命周期协同。

对现有方案的优化建议 #

你目前通过数据模型跟踪当前TabView的思路可行，可以结合上述方案2，将数据模型的选中状态与scenePhase结合，进一步提升工具栏显示的精准度，避免不必要的渲染判断。

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