SwiftUI中NSWindow无法在Mac所有Space显示的问题求助

核心问题 #

你的窗口无法跨Space显示的直接原因是**collectionBehavior设置冲突**：你同时指定了.stationary和.canJoinAllSpaces，其中.stationary会强制窗口固定在当前Space，完全抵消了.canJoinAllSpaces的作用。

另外，SwiftUI的WindowGroup自带窗口管理逻辑，可能会在你通过onAppear修改NSWindow属性后，自动重置部分配置，导致你的设置失效。

改进方案 #

方案一：修正现有代码（轻量调整） #

移除冲突的.stationary，改用SwiftUI原生修饰符确保配置生效：

import SwiftUI

@main
struct LyriXApp: App {
    var body: some Scene {
        WindowGroup("LyriX Overlay", id: "lyrix-overlay") {
            Text("LyriX App")
                .frame(width: 500, height: 100)
                .background(Color.green)
                .onAppear {
                    onPanelOpen()
                }
        }
        .windowResizability(.contentSize)
        .windowToolbarStyle(.unifiedCompact)
        .windowStyle(.hiddenTitleBar)
        .windowCollectionBehavior(.canJoinAllSpaces) // 用SwiftUI原生设置，避免被覆盖
    }
}

func onPanelOpen() {
    // 精准匹配目标窗口，避免误操作其他窗口
    guard let window = NSApp.windows.first(where: { $0.title == "LyriX Overlay" }) else {
        return
    }
    
    // 隐藏标准按钮
    window.standardWindowButton(.closeButton)?.isHidden = true
    window.standardWindowButton(.miniaturizeButton)?.isHidden = true
    window.standardWindowButton(.zoomButton)?.isHidden = true
    
    // 窗口样式配置
    window.titleVisibility = .hidden
    window.titlebarAppearsTransparent = true
    window.isMovableByWindowBackground = true
    window.level = .floating
    // 移除.utilityWindow，避免与.nonactivatingPanel冲突
    window.styleMask = [.fullSizeContentView, .borderless, .nonactivatingPanel]
    window.titlebarSeparatorStyle = .none
    window.isOpaque = false
    window.backgroundColor = .green
    // 仅保留.canJoinAllSpaces，移除冲突的.stationary
    window.collectionBehavior = .canJoinAllSpaces
    window.animationBehavior = .utilityWindow
    
    // 设置窗口位置（安全可选链，避免崩溃）
    guard let screenFrame = NSScreen.main?.visibleFrame else { return }
    let windowSize = CGSize(width: 500, height: 100)
    window.setFrame(CGRect(
        x: screenFrame.maxX - windowSize.width - 20,
        y: screenFrame.maxY - windowSize.height - 20,
        width: windowSize.width,
        height: windowSize.height
    ), display: true)
    
    window.orderFront(nil)
}

方案二：自定义窗口控制器（更可靠） #

如果SwiftUI的WindowGroup仍存在自动重置问题，可直接通过NSWindowController创建窗口，完全绕过SwiftUI的窗口管理：

import SwiftUI

@main
struct LyriXApp: App {
    // 绑定自定义AppDelegate
    @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    
    var body: some Scene {
        // 保留Settings场景，避免应用被系统判定为无窗口应用
        Settings {
            EmptyView()
        }
    }
}

class AppDelegate: NSObject, NSApplicationDelegate {
    private var overlayWindowController: NSWindowController?
    
    func applicationDidFinishLaunching(_ notification: Notification) {
        createOverlayWindow()
    }
    
    private func createOverlayWindow() {
        // 创建SwiftUI内容视图
        let contentView = Text("LyriX App")
            .frame(width: 500, height: 100)
            .background(Color.green)
        
        // 直接创建NSWindow
        let window = NSWindow(
            contentRect: NSRect(x: 0, y: 0, width: 500, height: 100),
            styleMask: [.fullSizeContentView, .borderless, .nonactivatingPanel],
            backing: .buffered,
            defer: false
        )
        window.contentView = NSHostingView(rootView: contentView)
        
        // 配置窗口属性
        window.title = "LyriX Overlay"
        window.titleVisibility = .hidden
        window.titlebarAppearsTransparent = true
        window.isMovableByWindowBackground = true
        window.level = .floating
        window.titlebarSeparatorStyle = .none
        window.isOpaque = false
        window.backgroundColor = .green
        window.collectionBehavior = .canJoinAllSpaces
        window.animationBehavior = .utilityWindow
        window.isReleasedWhenClosed = false // 关闭时不释放窗口，方便后续复用
        
        // 设置窗口位置到屏幕右上角
        guard let screenFrame = NSScreen.main?.visibleFrame else { return }
        window.setFrameOrigin(NSPoint(
            x: screenFrame.maxX - 520,
            y: screenFrame.maxY - 120
        ))
        
        // 创建并显示窗口
        overlayWindowController = NSWindowController(window: window)
        overlayWindowController?.showWindow(nil)
    }
}

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