如何在SwiftUI开发的macOS应用中限制仅打开单个窗口实例

方案1：SwiftUI 3+（macOS 12+ 推荐实现） #

苹果在SwiftUI 3版本新增了原生单窗口场景API，无需额外兼容代码即可实现需求：

@main
struct SingleWindowApp: App {
    var body: some Scene {
        // 将默认支持多实例的WindowGroup替换为Window
        Window("主窗口", id: "main") {
            ContentView()
        }
        // 可选：配置窗口大小规则
        .windowResizability(.contentSize)
        // 移除菜单栏默认的新建窗口选项
        .commands {
            CommandGroup(replacing: .newItem) { }
        }
    }
}

实现逻辑说明：

• Window场景默认仅允许创建1个实例，用户点击Dock图标只会唤起已存在的窗口，不会生成新窗口
• CommandGroup(replacing: .newItem) { }会直接删除「文件」菜单栏下的「新建窗口」选项，同时禁用对应的Cmd+N默认快捷键

如果你不需要完全移除「新建」分组，仅要删除新建窗口选项，可以在替换的CommandGroup内部保留其他你需要的自定义菜单项。

方案2：兼容macOS 11及更低版本 #

如果需要适配旧系统，需要结合NSApplicationDelegate拦截窗口创建逻辑：

1. 实现AppDelegate类

class AppDelegate: NSObject, NSApplicationDelegate {
    // 拦截Dock点击重开事件，已有可见窗口时不新建
    func applicationShouldHandleReopen(_ sender: NSApplication, hasVisibleWindows flag: Bool) -> Bool {
        return flag
    }
    
    // 拦截新建窗口响应，禁止触发新建逻辑
    func application(_ sender: NSApplication, delegateHandlesKey key: String) -> Bool {
        return key == "newWindow:"
    }
}

2. 绑定AppDelegate并移除菜单项

@main
struct SingleWindowApp: App {
    @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .commands {
            CommandGroup(replacing: .newItem) { }
        }
    }
}

效果验证 #

• 打开应用后查看「文件」菜单栏，确认「新建窗口」选项已移除
• 多次点击Dock应用图标，确认不会生成新窗口
• 按下Cmd+N快捷键，确认不会触发新窗口创建

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