MacOS SwiftUI隐藏标题栏保留标签时HSplitView覆盖标签栏如何解决？

问题根因 #

使用HiddenTitleBarWindowStyle时，HSplitView默认会忽略所有边缘的安全区域，直接延伸到整个窗口边界，而顶部标签栏/toolbar属于系统自动计算的顶部安全区范围，因此会出现HSplitView覆盖标签栏的问题。

规范解决方案 #

方案1：显式指定HSplitView忽略安全区的边缘（最推荐） #

仅让HSplitView忽略左右和底部的安全区，保留顶部安全区的适配逻辑，无需添加额外占位视图，属于SwiftUI标准安全区控制逻辑，无兼容性问题：

struct ContentView: View {
    var body: some View {
        NavigationView {
            Text("Sidebar")
            HSplitView {
                Text("left")
                    .frame(maxWidth: .infinity, maxHeight: .infinity)
                    .navigationTitle("tab name")
                Text("right")
                    .frame(maxWidth: .infinity, maxHeight: .infinity)
            }
            // 关键配置：仅忽略左右、底部安全区，保留顶部安全区适配
            .ignoresSafeArea(edges: [.leading, .trailing, .bottom])
            .toolbar {
                Button(action: {}){
                    Image(systemName: "arrow.triangle.turn.up.right.diamond")
                    Text("Button 1")
                }
            }
        }
    }
}

方案2：全局配置窗口toolbar样式 #

如果应用内所有窗口都需要适配该场景，可以直接在Scene层面统一配置，无需修改每个视图的布局代码：

@main
struct TestApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .windowStyle(HiddenTitleBarWindowStyle())
        // 全局指定统一toolbar样式，系统自动计算顶部安全区范围
        .windowToolbarStyle(.unified(showsTitle: false))
    }
}

该方案会让系统自动处理所有视图与toolbar的布局关系，适配性更强。

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