NSToolbarItemGroup无选中状态且点击不触发Action问题排查

你的问题源于NSToolbarItemGroup配置缺失几个关键步骤，以下是具体修复点：

1. 给子项启用边框支持选中高亮 #

普通NSToolbarItem默认不会显示选中状态，需给每个子项设置isBordered = true，让组能正确渲染选中高亮：

let item1 = NSToolbarItem(itemIdentifier: toolbarItemIdentifierItem1)
item1.image = NSImage(named: NSImage.addTemplateName)!
item1.label = "add"
item1.isBordered = true // 必须添加这一行
// item2、item3同理设置isBordered = true

2. 保持组的统一事件管理 #

不要给单个子项设置独立action，否则会绕过组的选中状态管理逻辑，仅保留给组设置的action和target即可。

3. 调整Toolbar初始化时机 #

原代码在viewDidAppear中创建Toolbar，可能导致窗口显示后才加载引发状态同步问题，建议移到viewDidLoad：

override func viewDidLoad() {
    super.viewDidLoad()
    let toolbar = NSToolbar()
    toolbar.delegate = self
    view.window!.toolbar = toolbar
    view.window!.toolbarStyle = .expanded
}

4. 优化action方法的参数类型 #

在响应方法中直接接收NSToolbarItemGroup类型参数，方便获取选中索引：

@objc func selectItem(_ sender: NSToolbarItemGroup) {
    print("当前选中索引：\(sender.selectedIndex)")
}

完整修复后的代码 #

class ViewController: NSViewController, NSToolbarDelegate {

    let toolbarItemIdentifier = NSToolbarItem.Identifier("group")
    let toolbarItemIdentifierItem1 = NSToolbarItem.Identifier("item1")
    let toolbarItemIdentifierItem2 = NSToolbarItem.Identifier("item2")
    let toolbarItemIdentifierItem3 = NSToolbarItem.Identifier("item3")

    override func viewDidLoad() {
        super.viewDidLoad()
        let toolbar = NSToolbar()
        toolbar.delegate = self
        view.window!.toolbar = toolbar
        view.window!.toolbarStyle = .expanded
    }
    
    func toolbarAllowedItemIdentifiers(_ toolbar: NSToolbar) -> [NSToolbarItem.Identifier] {
        return [.flexibleSpace, toolbarItemIdentifier]
    }
    
    func toolbarDefaultItemIdentifiers(_ toolbar: NSToolbar) -> [NSToolbarItem.Identifier] {
        return [.flexibleSpace, toolbarItemIdentifier, .flexibleSpace]
    }
    
    func toolbar(_ toolbar: NSToolbar, itemForItemIdentifier itemIdentifier: NSToolbarItem.Identifier, willBeInsertedIntoToolbar flag: Bool) -> NSToolbarItem? {
        switch itemIdentifier {
        case toolbarItemIdentifier:
            let item1 = NSToolbarItem(itemIdentifier: toolbarItemIdentifierItem1)
            item1.image = NSImage(named: NSImage.addTemplateName)!
            item1.label = "add"
            item1.isBordered = true
            
            let item2 = NSToolbarItem(itemIdentifier: toolbarItemIdentifierItem2)
            item2.image = NSImage(named: NSImage.homeTemplateName)!
            item2.label = "home"
            item2.isBordered = true
            
            let item3 = NSToolbarItem(itemIdentifier: toolbarItemIdentifierItem3)
            item3.image = NSImage(named: NSImage.pathTemplateName)!
            item3.label = "path"
            item3.isBordered = true
            
            let group = NSToolbarItemGroup(itemIdentifier: itemIdentifier)
            group.subitems = [item1, item2, item3]
            group.selectionMode = .selectOne
            group.selectedIndex = 0
            group.target = self
            group.action = #selector(selectItem(_:))
            return group
        default:
            return nil
        }
    }
    
    @objc func selectItem(_ sender: NSToolbarItemGroup) {
        print("当前选中索引：\(sender.selectedIndex)")
    }
}

额外说明 #

isBordered = true是让ToolbarItem显示选中高亮的核心配置，缺少该设置时，即使手动设置selectedIndex，系统也不会渲染选中状态。

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