如何创建无窗口的SwiftUI macOS菜单栏应用？

开发者阿泽

2026-10-19

解决方案

方案1：macOS 13+ 纯SwiftUI原生最优方案

SwiftUI 从 macOS 13 版本开始提供了专门用于菜单栏应用的MenuBarExtra场景，你可以直接删除原有WindowGroup，将MenuBarExtra作为唯一的场景，启动后不会生成任何多余窗口，也不需要手动管理NSPopover和状态栏项逻辑：

@main struct WeeksApp: App {
    @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    @Environment(\.calendar) var calendar
    
    var body: some Scene {
        // 完全替换原有的WindowGroup
        MenuBarExtra("Week \(calendar.component(.weekOfYear, from: Date()))") {
            ContentView(viewModel: appDelegate.viewModel)
        }
        // 设置为弹出窗口样式，和你原有Popover交互逻辑一致
        .menuBarExtraStyle(.window)
    }
}

如果需要保留原有的场景生命周期监听逻辑，直接加在MenuBarExtra后面即可。

方案2：兼容 macOS 12 及更低版本的原生方案

如果需要适配低版本系统无法使用MenuBarExtra，可以给原有WindowGroup添加原生修饰符，禁止窗口显示：

var body: some Scene {
    WindowGroup {
        EmptyView()
    }
    .windowStyle(.hiddenTitleBar)
    .windowResizability(.contentSize)
    .defaultSize(width: 0, height: 0)
    .onChange(of: scenePhase) { phase in
        // 进入活跃状态时主动关闭所有窗口，加双保险
        if phase == .active {
            NSApplication.shared.windows.forEach { $0.close() }
        }
        // 保留原有场景状态逻辑
        switch phase {
        case .background:
          print("Background")
        case .active:
          print("Active")
        case .inactive:
          print("Inactive")
        @unknown default:
          fatalError()
        }
    }
}