替换模型项时NSOutlineView reloadItem/reloadData失效问题

我之前也踩过NSOutlineView手动更新的坑，你的问题核心是没匹配好outlineView内部的树结构映射和模型的对应关系，以及不同刷新方法的适用场景。咱们逐个分析你的尝试，再给出正确的解决方案：

为什么你的之前的尝试无效？ #

1. reloadItem(oldFileItem)的问题 #

旧项已经从模型里移除了，outlineView的缓存里虽然还残留着它的视觉信息，但它已经不在当前的树结构中了。所以调用这个方法能刷新标题和图标（缓存没清），但展开三角是基于当前模型中新项的isExpandable，而旧项已经不存在，自然无法正确渲染展开状态——这个方法本来就不该用在已被移除的项上。

2. reloadData(forRowIndexes:columnIndexes:)的问题 #

这个方法只适用于**项本身数据更新（比如title变了，但项的身份没变）**的场景。你这里是直接替换了整个项，outlineView内部的row索引对应的还是旧项的信息，还没同步模型的变化，所以调用它相当于找错了对象，自然没效果。

3. removeItems/insertItems的问题 #

你提到“根节点isExpanded返回false，但子项可见”，这是关键的误区！NSOutlineView中，如果父项未展开，removeItems会直接跳过操作。你这里的“根节点”应该是指你的rootItem，如果它的isExpanded是false，那它的子项根本不该可见——这说明你的dataSource逻辑可能有问题，比如把虚拟根（item == nil的情况）和rootItem的关系搞混了，或者isItemExpandable的返回值不符合预期。

正确的解决方案 #

方案1：最简单的刷新——重载父项的子项 #

当你替换的是某个父项的子项时，直接重载父项并指定刷新子项，这是最稳妥的方式，还能保留父项的展开状态：

// 先更新模型
rootItem.children.remove(at: 0)
let newFolderItem = Item(title: "Folder", children:[], isExpandable:true)
rootItem.children.append(newFolderItem)

// 刷新rootItem，同时强制刷新它的子项
outlineView.reloadItem(rootItem, reloadChildren: true)

这个方法会让outlineView重新获取rootItem的子项列表，自动更新对应的行，新项的展开三角也会正常显示（因为isExpandable是true）。

方案2：带动画的更新——正确使用remove/insert #

如果你需要动画效果，得确保父项是展开状态，再用beginUpdates()包裹操作：

// 先记录旧项的状态（如果需要恢复展开）
let oldItem = rootItem.children.first!
let wasOldItemExpanded = outlineView.isItemExpanded(oldItem)

// 更新模型
rootItem.children.remove(at: 0)
let newFolderItem = Item(title: "Folder", children:[], isExpandable:true)
rootItem.children.append(newFolderItem)

// 确保父项（rootItem）是展开状态，否则remove/insert不会生效
if !outlineView.isItemExpanded(rootItem) {
    outlineView.expandItem(rootItem)
}

// 执行动画更新
outlineView.beginUpdates()
outlineView.removeItems(at: IndexSet(integer: 0), inParent: rootItem, withAnimation: .effectFade)
outlineView.insertItems(at: IndexSet(integer: 0), inParent: rootItem, withAnimation: .effectFade)
outlineView.endUpdates()

// 可选：如果需要让新项和旧项保持相同的展开状态
if wasOldItemExpanded {
    outlineView.expandItem(newFolderItem)
}

关键：检查你的DataSource逻辑 #

你提到的“根节点isExpanded返回false但子项可见”，大概率是dataSource的这几个方法逻辑有误，一定要确保它们和模型对应：

// 正确的数据源示例
func outlineView(_ outlineView: NSOutlineView, numberOfChildrenOfItem item: Any?) -> Int {
    if item == nil {
        // 虚拟根节点的子项是你的rootItem
        return 1
    } else if let item = item as? Item {
        return item.children.count
    }
    return 0
}

func outlineView(_ outlineView: NSOutlineView, child index: Int, ofItem item: Any?) -> Any {
    if item == nil {
        return rootItem
    } else if let item = item as? Item {
        return item.children[index]
    }
    fatalError("Unexpected item type")
}

func outlineView(_ outlineView: NSOutlineView, isItemExpandable item: Any) -> Bool {
    guard let item = item as? Item else { return false }
    return item.isExpandable
}

只有数据源逻辑正确，outlineView的展开状态、子项显示才会和模型一致，后续的刷新操作才能生效。

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