macOS下SwiftUI设置窗口隐藏标题栏问题求助

核心原因 #

系统默认的Settings场景窗口有特殊样式优先级，直接在内部视图添加.windowStyle(.hiddenTitleBar)或.presentedWindowStyle(.hiddenTitleBar)会被系统覆盖，尤其是搭配NavigationSplitView时，默认标题栏绑定了系统设置窗口的固有逻辑。

具体解决步骤 #

1. 在App层级直接配置Settings窗口样式 #

不要在Settings内部视图中设置窗口样式，而是在App结构体的Settings场景定义里直接配置：

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        
        Settings {
            SettingsView()
        }
        .windowStyle(.hiddenTitleBar) // 直接在此处配置窗口样式
    }
}

2. 清除NavigationSplitView的默认标题残留 #

如果仍有标题显示，需要在NavigationSplitView的侧边栏和详情页中明确隐藏导航栏并清空标题：

struct SettingsView: View {
    var body: some View {
        NavigationSplitView {
            SidebarView()
                .navigationTitle("")
                .navigationBarHidden(true)
        } detail: {
            DetailView()
                .navigationTitle("")
                .navigationBarHidden(true)
        }
        .navigationSplitViewStyle(.balanced) // 可选，匹配Xcode的侧边栏布局比例
    }
}

3. 强制覆盖系统默认标题 #

如果系统仍顽固显示“My App Settings”，可以在Settings场景内强制设置空标题：

Settings {
    SettingsView()
        .navigationTitle("")
}
.windowStyle(.hiddenTitleBar)

额外提示 #

Xcode 26的设置界面是完全自定义的无标题栏样式，要确保你的NavigationSplitView没有启用多余的导航栏交互，同时检查是否有其他视图层级的.navigationTitle或.toolbar设置干扰了整体样式。

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