SwiftUI macOS：快捷键控制窗口显隐仅生效一次的问题求解

核心问题分析 #

你当前的实现只生效一次，是因为调用window?.close()会销毁窗口实例——窗口关闭后就不存在了，后续再触发快捷键激活应用时，没有可显示的窗口对象。另外，在scenePhase变化时重复绑定keyUpHandler也可能导致逻辑混乱。

调整方案 #

1. 改用窗口隐藏/显示替代关闭操作 #

不要调用close()，而是用window?.orderOut(nil)隐藏窗口，或者window?.isHidden = true。需要显示时，再调用window?.makeKeyAndOrderFront(nil)。

2. 统一管理快捷键的Handler逻辑 #

把快捷键的按下和松开逻辑集中处理，避免分散在AppDelegate和App结构体中，同时避免重复绑定keyUpHandler。

完整调整示例 #

第一步：在AppDelegate中统一管理快捷键逻辑

class AppDelegate: NSObject, NSApplicationDelegate {
    var hotkey: HotKey? // 假设你用的是HotKey库
    var window: NSWindow?

    func applicationWillFinishLaunching(_ notification: Notification) {
        NSApp.setActivationPolicy(.accessory)
        
        // 初始化快捷键（示例组合键，根据你的实际设置调整）
        hotkey = HotKey(key: .space, modifiers: [.command, .shift])
        
        // 绑定按下事件：显示窗口并激活应用
        hotkey?.keyDownHandler = { [weak self] in
            guard let self = self else { return }
            NSApplication.shared.activate(ignoringOtherApps: true)
            // 确保窗口存在并显示
            if let window = self.window {
                if window.isHidden {
                    window.makeKeyAndOrderFront(nil)
                }
            }
        }
        
        // 绑定松开事件：隐藏窗口
        hotkey?.keyUpHandler = { [weak self] in
            self?.window?.orderOut(nil)
        }
    }
    
    // 保存窗口引用
    func applicationDidBecomeActive(_ notification: Notification) {
        if let mainWindow = NSApp.mainWindow {
            self.window = mainWindow
        }
    }
}

第二步：简化App结构体中的逻辑

不需要在scenePhase变化时再绑定keyUpHandler，保持窗口定义简洁：

@main
struct FooApp: App {
    @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    
    var body: some Scene {
        Window("FooWindow", id: "switcher") {
            // 你的窗口内容
        }
        // 可选：设置窗口初始隐藏
        .windowStyle(.hiddenTitleBar)
        .onAppear {
            if let window = NSApp.windows.first(where: { $0.identifier?.rawValue == "switcher" }) {
                appDelegate.window = window
                window.orderOut(nil) // 初始隐藏
            }
        }
    }
}

额外注意事项 #

• 如果使用第三方快捷键库（比如HotKey），确保keyDownHandler和keyUpHandler的弱引用正确，避免循环引用。
• 不要调用close()，除非你确实需要销毁窗口并重建——但对于快捷键触发的显示/隐藏场景，隐藏窗口的性能和复用性更好。
• 确保窗口引用window被正确持有，避免出现nil导致操作失效。

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