macOS下SwiftUI模态窗口带ButtonStyle的按钮点击失效问题

在macOS SwiftUI中使用NSApp.runModal打开模态窗口时，模态内带自定义ButtonStyle的按钮点击事件会延迟到窗口关闭后才触发，而原生无样式按钮可正常响应，这是因为SwiftUI的事件处理队列与AppKit模态循环的冲突导致的：

• NSApp.runModal启动的是AppKit层级的模态循环，会阻塞SwiftUI的内部事件派发队列
• 自定义ButtonStyle的按钮事件依赖SwiftUI的事件队列，因此会被暂存到模态结束后才执行
• 原生无样式按钮直接绑定AppKit原生事件处理逻辑，不受此阻塞影响

修复方案 #

方案1：用DispatchQueue.main.async包裹按钮动作 #

将模态窗口内带样式按钮的动作逻辑放到主队列异步执行，让事件在模态循环的事件链中即时处理：

struct ModalView: View {
    @State private var message = "未点击"
    
    var body: some View {
        VStack {
            Text(message)
            Button("带样式按钮（修复后）", action: {
                DispatchQueue.main.async {
                    message = "已点击带样式按钮"
                    // 关闭模态窗口
                    if let window = NSApp.keyWindow {
                        NSApp.stopModal()
                    }
                }
            })
            .buttonStyle(CustomButtonStyle())
            
            Button("无样式按钮（正常响应）", action: {
                message = "已点击无样式按钮"
            })
        }
        .padding()
    }
}

方案2：桥接AppKit原生按钮（NSButton） #

通过NSViewRepresentable自定义一个基于AppKit的按钮，直接使用原生事件处理逻辑，彻底规避SwiftUI事件队列的阻塞问题：

// 自定义AppKit按钮组件
struct AppKitCustomButton: NSViewRepresentable {
    let title: String
    let action: () -> Void
    
    func makeNSView(context: Context) -> NSButton {
        let button = NSButton(title: title, target: context.coordinator, action: #selector(Coordinator.buttonTapped))
        button.bezelStyle = .rounded
        button.wantsLayer = true
        button.layer?.backgroundColor = NSColor.blue.cgColor
        button.layer?.cornerRadius = 8
        button.contentTintColor = .white
        return button
    }
    
    func updateNSView(_ nsView: NSButton, context: Context) {
        nsView.title = title
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(action: action)
    }
    
    class Coordinator: NSObject {
        let action: () -> Void
        
        init(action: @escaping () -> Void) {
            self.action = action
        }
        
        @objc func buttonTapped() {
            action()
        }
    }
}

// 在模态窗口中使用
struct ModalView: View {
    @State private var message = "未点击"
    
    var body: some View {
        VStack {
            Text(message)
            AppKitCustomButton(title: "AppKit自定义按钮（正常响应）") {
                message = "已点击AppKit自定义按钮"
                if let window = NSApp.keyWindow {
                    NSApp.stopModal()
                }
            }
            
            Button("无样式按钮（正常响应）", action: {
                message = "已点击无样式按钮"
            })
        }
        .padding()
    }
}

如果不需要完全依赖AppKit的runModal，也可以考虑使用SwiftUI原生的.fullScreenCover或.sheet配合.modalPresentationStyle(.fullScreen)来实现类似的阻塞效果，但这种方式下主窗口仍会保留部分交互能力，需根据需求选择。

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