SwiftUI中NavigationSplitView全屏时工具栏不显示背景图问题

1. 把背景视图移到Window层级 #

MacOS全屏模式下，工具栏的渲染层级会高于NavigationSplitView的背景，你可以将背景视图直接放在WindowGroup的根ZStack里，确保它处于所有内容的最底层：

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            ZStack {
                SidebarBackgroundView()
                    .ignoresSafeArea()
                NavigationSplitView {
                    VStack {
                        // 侧边栏内容
                    }
                    .navigationSplitViewColumnWidth(ideal: 200)
                } detail: {
                    // 详情页内容
                }
                .toolbar {
                    ToolbarItem(placement: .navigation) {
                        StatusManagerView()
                    }
                }
                .background(.clear) // 让NavigationSplitView本身透明
            }
        }
    }
}

2. 设置工具栏为透明 #

显式将工具栏背景设为透明，避免它遮挡底层背景图：

.toolbar {
    ToolbarItem(placement: ToolbarItemPlacement.navigation) {
        StatusManagerView()
    }
}
.toolbarBackground(.clear, for: .windowToolbar)

如果需要兼容macOS 13以下版本，可以用AppKit API直接修改窗口工具栏：

// 在视图的onAppear里调用
.onAppear {
    NSApp.windows.forEach { window in
        window.toolbar?.isTransparent = true
    }
}

3. 简化背景视图的布局逻辑 #

去掉SidebarBackgroundView里多余的GeometryReader和手动frame约束，让图片自动适配整个窗口：

struct SidebarBackgroundView : View {
    var body : some View {
        Image(backgroundImageName)
            .resizable()
            .aspectRatio(contentMode: .fill)
            .blur(radius: 4.0, opaque: true)
            .ignoresSafeArea(.all)
    }
}

原有的GeometryReader可能在全屏触发时导致布局计算偏差，简化后能更可靠地填充整个窗口区域。

4. 确保NavigationSplitView本身透明 #

给NavigationSplitView设置透明背景，避免系统默认的白色背景覆盖自定义背景：

NavigationSplitView {
    // 侧边栏内容
} detail: {
    // 详情页内容
}
.background(.clear)

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