SwiftUI文档型App中如何正确使用Commands实现窗口级命令？

我开发了一个支持多文档同时打开的SwiftUI文档型App，需求是让主菜单的菜单项能向活动窗口发送命令，且当活动窗口没有匹配对象选中时，菜单项自动禁用（类似Finder的Edit菜单随选中文件变化的逻辑）。

我尝试用共享AppState类实现视图与Commands的通信，虽然基本能用，但存在两个核心问题：

• 命令会被发送给所有已打开的文档，无法精准定位到活动窗口；
• 不同窗口的选中状态独立时，AppState只会记录最后一次的选中状态，切换窗口时应用无法感知状态变化，导致菜单状态不匹配。

我的代码示例如下：

共享AppState实现 #

class AppState: ObservableObject
{
    static let shared = AppState()

    @Published var dirEntryCommand = PassthroughSubject<DirCommand,Never>()
    @Published var selectedDirEntry: DirectoryEntry.ID?
}

Commands结构 #

enum DirCommand: Int, Identifiable, CaseIterable
{
    case rename
    case moveUp
    case moveDown
    
    var id: RawValue { rawValue }
}

struct DirEntryCommands: Commands
{
    @ObservedObject var appState = AppState.shared
    
    var body: some Commands {
        CommandMenu("Directory Entry") {
            Section {
                Button("Move up") {
                    appState.dirEntryCommand.send(.moveUp)
                }
                .keyboardShortcut("u")
                Button("Move down") {
                    appState.dirEntryCommand.send(.moveDown)
                }
                .keyboardShortcut("d")
            }
            .disabled(appState.selectedDirEntry == nil)
            Section {
                Button("Rename…") {
                    appState.dirEntryCommand.send(.rename)
                }
                .keyboardShortcut("r")
            }
            .disabled(appState.selectedDirEntry == nil)
        }
    }
}

在纯AppKit应用中，我会通过ViewController实现命令并利用Responder Chain机制解决这类问题，但不清楚SwiftUI文档型App里该怎么处理，希望得到替代方案。

针对多文档场景下的菜单命令精准响应问题，提供两种贴合macOS平台逻辑的实现方案：

方案1：纯SwiftUI文档级状态绑定 #

每个文档维护独立的选中状态，通过Environment和活动窗口关联，实现命令的精准发送和菜单状态同步：

1. 为文档添加专属选中状态

struct YourDocument: FileDocument {
    // 原有文档数据
    var entries: [DirectoryEntry]
    // 文档独立的选中项ID
    @Published var selectedEntryId: DirectoryEntry.ID?
    
    // ... 实现FileDocument协议的其他代码
}

2. 视图中绑定文档选中状态

struct DocumentView: View {
    @Binding var document: YourDocument
    
    var body: some View {
        List(document.entries, selection: $document.selectedEntryId) { entry in
            Text(entry.name)
        }
    }
}

3. 修改Commands关联活动文档
   通过@Environment(\.openWindows)获取当前活动窗口对应的文档，直接操作目标文档：

struct DirEntryCommands: Commands {
    @Environment(\.openWindows) private var openWindows
    
    private var activeDocument: YourDocument? {
        // 定位活动窗口对应的文档实例
        openWindows.first(where: { $0.isActive })?.rootViewController?.representedObject as? YourDocument
    }
    
    var body: some Commands {
        CommandMenu("Directory Entry") {
            Section {
                Button("Move up") {
                    guard let entryId = activeDocument?.selectedEntryId else { return }
                    activeDocument?.moveEntryUp(withId: entryId)
                }
                .keyboardShortcut("u")
                Button("Move down") {
                    guard let entryId = activeDocument?.selectedEntryId else { return }
                    activeDocument?.moveEntryDown(withId: entryId)
                }
                .keyboardShortcut("d")
            }
            .disabled(activeDocument?.selectedEntryId == nil)
            
            Section {
                Button("Rename…") {
                    guard let entryId = activeDocument?.selectedEntryId else { return }
                    activeDocument?.renameEntry(withId: entryId)
                }
                .keyboardShortcut("r")
            }
            .disabled(activeDocument?.selectedEntryId == nil)
        }
    }
}

方案2：桥接AppKit Responder Chain #

复用AppKit成熟的Responder机制，让SwiftUI视图接入系统响应链，实现菜单状态自动校验和命令精准分发：

1. 创建命令响应者类

class EntryCommandResponder: NSResponder {
    weak var document: YourDocument?
    
    override func performAction(_ action: Selector) -> Bool {
        guard let doc = document, let entryId = doc.selectedEntryId else { return false }
        switch action {
        case #selector(moveUp):
            doc.moveEntryUp(withId: entryId)
            return true
        case #selector(moveDown):
            doc.moveEntryDown(withId: entryId)
            return true
        case #selector(rename):
            doc.renameEntry(withId: entryId)
            return true
        default:
            return super.performAction(action)
        }
    }
    
    @objc func moveUp() {}
    @objc func moveDown() {}
    @objc func rename() {}
    
    // 自动校验菜单启用状态
    override func validateMenuItem(_ menuItem: NSMenuItem) -> Bool {
        guard let doc = document else { return false }
        switch menuItem.action {
        case #selector(moveUp), #selector(moveDown), #selector(rename):
            return doc.selectedEntryId != nil
        default:
            return super.validateMenuItem(menuItem)
        }
    }
}

2. 在SwiftUI视图中嵌入响应者

struct ResponderBridgeView: NSViewRepresentable {
    @Binding var document: YourDocument
    
    func makeNSView(context: Context) -> NSView {
        let view = NSView()
        let responder = EntryCommandResponder()
        responder.document = document
        // 将响应者加入视图的响应链
        view.nextResponder = responder
        return view
    }
    
    func updateNSView(_ nsView: NSView, context: Context) {
        (nsView.nextResponder as? EntryCommandResponder)?.document = document
    }
}

// 在文档视图中添加桥接视图
struct DocumentView: View {
    @Binding var document: YourDocument
    
    var body: some View {
        List(document.entries, selection: $document.selectedEntryId) { entry in
            Text(entry.name)
        }
        .background(ResponderBridgeView(document: $document))
    }
}

3. 注册菜单关联响应者方法

struct DirEntryCommands: Commands {
    var body: some Commands {
        CommandMenu("Directory Entry") {
            Button("Move up") {
                NSApp.sendAction(#selector(EntryCommandResponder.moveUp), to: nil, from: nil)
            }
            .keyboardShortcut("u")
            
            Button("Move down") {
                NSApp.sendAction(#selector(EntryCommandResponder.moveDown), to: nil, from: nil)
            }
            .keyboardShortcut("d")
            
            Divider()
            
            Button("Rename…") {
                NSApp.sendAction(#selector(EntryCommandResponder.rename), to: nil, from: nil)
            }
            .keyboardShortcut("r")
        }
    }
}

方案对比 #

• 方案1纯SwiftUI实现，贴合SwiftUI文档架构，无需依赖AppKit，但需要手动定位活动文档；
• 方案2复用AppKit响应链逻辑，菜单状态校验更自动化，符合macOS原生应用的交互习惯，适合熟悉AppKit的开发者。

内容的提问来源于stack exchange，提问作者D. Mika