macOS Finder扩展NSMenuItem.separator()显示空白无分隔线如何解决

问题背景 #

开发macOS平台Finder扩展时，向Finder上下文菜单添加分隔线后，分隔元素仅显示空白，未渲染出预期的可见分隔线条：

• 实际运行效果：
• 预期实现效果：

复现代码 #

let main = NSMenu() 
let submenu = NSMenu()
let mainDropdown = NSMenuItem(
    title: "Extension menu",
    action: nil,
    keyEquivalent: ""
)

main.addItem(mainDropdown)
main.setSubmenu(submenu, for: mainDropdown)

let all = NSMenuItem(
    title: "All",
    action: nil,
    keyEquivalent: ""
)
all.isEnabled = false
submenu.addItem(all)
            
submenu.addItem(.separator())

查阅苹果官方NSMenuItem.separator()开发文档，文档标注该类菜单项为禁用状态，默认分隔项为空白，无法直接渲染出原生菜单的可见分隔线。

解决方案 #

该问题是Finder扩展跨进程菜单渲染的已知兼容问题：直接通过NSMenuItem.separator()构造的分隔项，在通过XPC传递给Finder进程渲染时会丢失分隔线类型标记，最终仅渲染为空白行。
不要使用默认的.separator()构造方法，手动创建NSMenuItem实例并显式标记为分隔项即可，注意不要给分隔项设置任何多余属性：

// 替换原代码中的 submenu.addItem(.separator())
let separatorItem = NSMenuItem()
separatorItem.isSeparatorItem = true
// 不要给分隔项设置title、action、keyEquivalent、target、自定义view等属性
submenu.addItem(separatorItem)

如果上述写法仍未正常显示分隔线，排查两项配置：

• 确认没有全局遍历菜单项时给分隔项设置isEnabled = true，分隔项必须保持禁用状态
• 确认没有给NSMenu或菜单项设置自定义appearance属性，跨进程渲染场景下自定义外观会导致分隔线样式无法正常绘制

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