iOS转macOS开发者求教：如何在XIB文件中指定NSMenu为主菜单？

Hey there! 作为从iOS转过来搞macOS开发的同行，太懂这种刚上手踩坑的感觉了😉 你遇到的「自定义菜单不被系统识别、显示成垂直堆叠」的问题其实挺常见的，我来一步步给你捋清楚怎么解决：

一、手动加载自定义XIB并关联主菜单 #

默认模板是通过Info.plist里的Main nib file base name自动加载主菜单XIB的，但当你删除默认XIB并新建自定义版本后，系统没法自动关联了，得在代码里手动操作：

打开AppDelegate.swift，在applicationDidFinishLaunching方法里添加以下代码：

func applicationDidFinishLaunching(_ aNotification: Notification) {
    // 替换成你的自定义菜单XIB名称
    guard let menuNib = NSNib(nibNamed: NSNib.Name("YourCustomMenu"), bundle: nil) else {
        print("Failed to load custom menu XIB")
        return
    }
    
    var topLevelObjects: NSArray?
    if menuNib.instantiate(withOwner: nil, topLevelObjects: &topLevelObjects) {
        // 从XIB的顶级对象中筛选出NSMenu实例
        if let mainMenu = topLevelObjects?.compactMap({ $0 as? NSMenu }).first {
            // 将其设置为应用的主菜单
            NSApp.mainMenu = mainMenu
        } else {
            print("No NSMenu found in the custom XIB")
        }
    }
}

这段代码的核心是：手动实例化自定义XIB，从中取出NSMenu对象，然后赋值给NSApp.mainMenu——这是系统识别主菜单的关键入口。

二、修正菜单垂直堆叠的问题 #

菜单显示成垂直堆叠，大概率是你的XIB里菜单结构不对。macOS的主菜单有严格的层级要求：

• 根对象必须是NSMenu：这个是菜单栏的容器
• 根菜单里的子项是NSMenuItem：比如「File」「Edit」「View」这些顶级菜单标题
• 每个顶级NSMenuItem需要关联一个submenu：点击标题时弹出的下拉菜单，才是放具体操作项（比如「New」「Open」）的地方

如果直接把所有菜单项都塞进根NSMenu里，系统就会把它们当成顶级菜单垂直排列，而不是横向展示的下拉结构。

调整XIB结构的步骤： #

1. 打开自定义菜单XIB，确保顶级对象里有一个NSMenu（如果没有，拖一个NSMenu到XIB的对象面板）
2. 给根NSMenu添加NSMenuItem，设置好title（比如「File」）
3. 拖一个新的NSMenu到对象面板，把它关联到刚才的NSMenuItem的submenu属性上
4. 在这个子NSMenu里添加具体的菜单项（比如「New」「Save」）
5. 重复上述步骤，添加「Edit」「View」等其他顶级菜单

三、额外注意事项 #

• 删掉Info.plist里的Main nib file base name键（如果之前指向的是默认MainMenu），避免和手动加载的XIB冲突
• 确保自定义XIB里的NSMenu没有设置奇怪的布局约束——macOS主菜单的布局是系统管控的，不需要手动加约束

这样操作后，你的自定义菜单应该就能正常被系统识别，并且以标准的横向菜单栏样式展示了！

内容的提问来源于stack exchange，提问作者Mark A. Donohoe