在AppKit中使用NSMenu添加应用菜单时的初始化报错问题

咱们来一步步解决你遇到的这两个问题，顺便给你理顺自定义NSMenu的正确实现方式：

错误原因拆解与修复 #

1. 「Expected parameter type following ':'」语法错误 #

你在自定义myMenu的初始化器里写了init(aTitle: "HelloWorld")，这是典型的Swift语法错误——初始化器的参数必须声明类型，而不是直接传字面量值。正确的写法是先指定参数类型为String，再在初始化器内部调用父类的初始化方法来完成菜单的基础初始化。

2. 「'required' initializer 'init(coder:)' must be provided」继承要求错误 #

NSMenu是遵循NSCoding协议的Objective-C框架类，这个协议要求所有子类必须实现init(coder:)这个必要初始化器。解决这个问题有两种简单方式：

• 给自定义菜单类加上@objcMembers属性，让Swift自动生成Objective-C兼容的必要初始化器
• 显式实现init(coder:)方法（即使内部只调用父类实现）

另外还要纠正一个代码组织问题：你把自定义myMenu类定义在了applicationDidFinishLaunching方法内部，虽然Swift允许这么做，但这会降低代码可读性和复用性，建议把自定义类移到全局作用域或者AppDelegate类的外部。

修正后的完整代码示例 #

第一步：定义自定义NSMenu子类 #

@objcMembers class CustomMenu: NSMenu {
    // 自定义初始化器，接收菜单标题
    init(customTitle: String) {
        // 必须调用父类的初始化方法完成基础设置
        super.init(title: customTitle)
        
        // 这里可以添加自定义菜单项（示例）
        let testItem = NSMenuItem(title: "我的自定义菜单项", action: #selector(handleMenuItemTap), keyEquivalent: "")
        addItem(testItem)
    }
    
    // 必要初始化器，满足NSCoding协议要求
    required init(coder: NSCoder) {
        super.init(coder: coder)
    }
    
    // 菜单项的点击事件处理（必须标记@objc才能被Objective-C框架识别）
    @objc private func handleMenuItemTap() {
        print("自定义菜单项被点击啦！")
    }
}

第二步：在AppDelegate中使用自定义菜单 #

class AppDelegate: NSObject, NSApplicationDelegate {
    var window: NSWindow!

    func applicationDidFinishLaunching(_ aNotification: Notification) {
        // 原来的窗口创建代码保持不变
        let contentView = ContentView()
        window = NSWindow(
            contentRect: NSRect(x: 0, y: 0, width: 480, height: 512),
            styleMask: [.titled, .closable, .miniaturizable, .resizable, .fullSizeContentView],
            backing: .buffered,
            defer: false)
        window.isReleasedWhenClosed = false
        window.center()
        window.setFrameAutosaveName("Main Window")
        window.contentView = NSHostingView(rootView: contentView)
        window.makeKeyAndOrderFront(nil)
        
        // 创建自定义菜单实例
        let myCustomMenu = CustomMenu(customTitle: "HelloWorld")
        
        // 方式1：将自定义菜单设置为应用的主菜单
        let mainMenu = NSMenu()
        let mainMenuItem = NSMenuItem(title: "自定义菜单", action: nil, keyEquivalent: "")
        mainMenuItem.submenu = myCustomMenu
        mainMenu.addItem(mainMenuItem)
        NSApplication.shared.mainMenu = mainMenu
        
        // 方式2：如果要给当前窗口单独设置菜单
        // window.menu = myCustomMenu
    }
}

关键注意点 #

• 所有和AppKit框架交互的方法（比如菜单项的action）必须标记@objc，否则Objective-C框架无法识别
• 自定义NSMenu子类必须正确调用父类的初始化方法，否则会导致初始化不完整
• 如果你的菜单需要从Storyboard/XIB加载，init(coder:)方法会被调用，所以必须保证它能正常工作

内容的提问来源于stack exchange，提问作者Soulfire J. Backblaze