NSOutlineView不可折叠分组行的显示/隐藏按钮禁用问题

我完全懂你遇到的别扭情况——shouldCollapseItem返回false确实能拦住用户折叠指定行，但系统不会自动把对应的展开/折叠按钮灰掉，导致按钮看起来还是可点的，体验特别不一致。下面是完整的解决方案，帮你实现像Mail.app里“Mailboxes”分组那样的效果：

1. 先筑牢折叠拦截的基础 #

首先，你的shouldCollapseItem代理方法要准确返回false，把用户的折叠操作拦下来：

func outlineView(_ outlineView: NSOutlineView, shouldCollapseItem item: Any) -> Bool {
    // 这里替换成你的业务判断逻辑，比如判断当前item是不是不可折叠的分组
    return !outlineView.isGroupItem(item)
}

2. 手动禁用展开/折叠按钮 #

接下来，在willDisplayOutlineCell方法里找到系统自带的disclosure按钮，根据是否允许折叠来设置它的启用状态。系统的这个按钮有固定的标识符，我们可以靠它定位：

func outlineView(_ outlineView: NSOutlineView, willDisplayOutlineCell cell: Any, for tableColumn: NSTableColumn?, item: Any) {
    // 先把cell转换成我们能操作的NSTableCellView
    guard let tableCellView = cell as? NSTableCellView else { return }
    
    // 筛选出系统的disclosure按钮
    let disclosureButton = tableCellView.subviews.first { subview in
        guard let button = subview as? NSButton else { return false }
        return button.identifier?.rawValue == "NSOutlineViewDisclosureButton"
    } as? NSButton
    
    guard let button = disclosureButton else { return }
    
    // 复用shouldCollapseItem的判断逻辑，设置按钮是否可用
    let canCollapse = outlineView.delegate?.outlineView?(outlineView, shouldCollapseItem: item) ?? true
    button.isEnabled = canCollapse
    
    // 额外优化：如果不允许折叠，确保按钮显示正确的状态（比如展开状态不会被误点切换）
    if !canCollapse {
        button.state = outlineView.isItemExpanded(item) ? .on : .off
    }
}

3. 动态状态变化时的处理 #

如果你的数据模型里，某个item的可折叠状态可能动态改变，记得调用下面的方法刷新对应行的UI：

outlineView.reloadItem(yourTargetItem, reloadChildren: false)

为啥要这么折腾？ #

系统的NSOutlineView设计里，shouldCollapseItem只是个行为拦截器——它只管阻止折叠动作，不会自动同步UI状态。所以我们必须手动找到按钮并修改它的启用状态，才能让用户一眼就知道这行是没法折叠的。

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