SwiftUI macOS 如何实现按住Option键切换菜单替代项

• macOS原生应用默认支持交互：打开主菜单栏菜单时按住Option键，部分菜单项会自动切换显示内容与对应动作，典型案例是Safari浏览器打开「File」菜单时，默认显示「Close Tab」，按住Option键后自动切换为「Close Other Tabs」
• AppKit框架下该效果通过设置NSMenuItem的isAlternate属性即可实现，但纯SwiftUI开发时存在两个核心阻塞问题：
  1. 自定义NSResponder接入响应链后，常规状态下可通过flagsChanged回调捕获Option键按下事件，但菜单处于打开状态时，系统会独占事件流，该回调不会触发，无法实时获取按键状态
  2. 即使绕过事件流限制实现了菜单打开状态下的Option键监听，修改Commands构建依赖的状态变量时，SwiftUI会触发菜单重建直接关闭已打开的菜单，无法实现菜单项动态更新同时保持菜单开启的原生效果，问题复现代码如下：

var body: some Commands {
   // 菜单打开时如果isOptionDown状态变化，SwiftUI不会更新菜单项，只会直接关闭菜单
   // 该交互完全不符合macOS原生应用的行为逻辑
   CommandGroup(replacing: .pasteboard) {
      Button(...)
      if optionKeyWatcher.isOptionDown {
          Button(/* Option按下时显示的项 */)
      } else {
          Button(/* 默认显示的项 */)
      }
   }
}

实现方案 #

SwiftUI 从macOS 10.15到最新的macOS 14版本，Commands模块均未暴露alternate菜单项的公开配置API，不要尝试通过状态驱动动态切换菜单项的路径，该路径受SwiftUI菜单更新机制限制必然导致菜单关闭，正确实现方式是通过轻量AppKit桥接，复用系统原生的菜单项替换逻辑，不需要自行监听按键状态。

具体实现步骤：

1. 放弃条件分支渲染菜单项的逻辑，在CommandGroup/CommandMenu中同时放入常规状态、Option按下状态对应的两个菜单项，分别配置对应的快捷键（常规项配置不带Option的快捷键，替换项配置带Option修饰的同按键快捷键）
2. 监听系统菜单新增item的通知，找到需要作为替换项的NSMenuItem，将其isAlternate属性设置为true，后续所有修饰键检测、菜单项切换逻辑完全由系统原生处理，和系统应用表现完全一致

基础实现代码如下：

import AppKit
import SwiftUI

@main
struct MyApp: App {
    init() {
        // 监听菜单项加载事件，配置替换项属性
        NotificationCenter.default.addObserver(
            forName: NSMenu.didAddItemNotification,
            object: nil,
            queue: .main
        ) { notification in
            guard let targetItem = notification.userInfo?["NSMenuItem"] as? NSMenuItem else { return }
            // 匹配需要设置为Option替换项的菜单项：判断逻辑可根据自身业务调整，比如匹配快捷键、匹配标题
            if targetItem.keyEquivalent == "n" && targetItem.keyEquivalentModifierMask == [.command, .option] {
                targetItem.isAlternate = true
            }
        }
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }.commands {
            CommandGroup(replacing: .newItem) {
                // 默认显示的常规菜单项
                Button {
                    newFolder()
                } label: {
                    Text("New Folder")
                }
                .keyboardShortcut("n", modifiers: .command)

                // Option按下时显示的替换菜单项，直接放在相邻位置即可，不需要条件判断
                Button {
                    newSmartFolder()
                } label: {
                    Text("New Smart Folder")
                }
                .keyboardShortcut("n", modifiers: [.command, .option])
            }        
        }
    }

    private func newFolder() {
        // 常规菜单项逻辑
    }

    private func newSmartFolder() {
        // Option替换菜单项逻辑
    }
}

方案说明 #

• 全程不需要自行监听Option键按下/抬起事件，所有状态判断、菜单项显隐切换完全走系统原生逻辑，不存在菜单打开时事件捕获失效的问题
• 两个菜单项在菜单初始化时就已完成加载，不存在运行时动态增删菜单项的操作，完全不会触发菜单关闭，交互和Safari、访达等原生应用完全一致
• 桥接代码侵入性极低，不需要重写现有SwiftUI菜单结构，仅需在应用启动时加一段菜单项属性配置逻辑即可
• 注意替换菜单项必须和对应常规菜单项位置相邻，且基础快捷键（除Option修饰符外的按键、其他修饰符）保持一致，系统才能正确识别二者的替换关系

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