NSCollectionView拖拽显示空白，如何实现Finder式拖拽效果？

这个问题我之前也碰到过！NSCollectionView默认的拖拽行为确实会把源单元格变空白，要实现Finder那种「原图标留原位，同时拖出镜像」的效果，核心是要改掉系统默认的源项目处理逻辑，具体可以按这几步来：

1. 正确配置拖拽源代理的关键方法 #

你需要实现NSCollectionViewDataSource和NSCollectionViewDelegateDragSource协议里的几个核心方法，重点是自定义拖拽镜像和禁用源项目自动移动：

（1）允许拖拽并写入粘贴板数据 #

首先确保允许拖拽，并把拖拽需要的数据写入粘贴板：

func collectionView(_ collectionView: NSCollectionView, canDragItemsAt indexPaths: Set<IndexPath>, with event: NSEvent) -> Bool {
    return true
}

func collectionView(_ collectionView: NSCollectionView, writeItemsAt indexPaths: Set<IndexPath>, to pasteboard: NSPasteboard) -> Bool {
    // 这里写入你的业务数据，比如item的ID或内容，根据需求调整
    let items = indexPaths.map { yourDataArray[$0.item] }
    pasteboard.writeObjects(items as [NSPasteboardWriting])
    return true
}

（2）自定义拖拽镜像 #

这一步是关键！系统默认会截取源单元格作为拖拽镜像，同时隐藏原单元格。我们自己生成拖拽镜像，就能避免原单元格被隐藏：

func collectionView(_ collectionView: NSCollectionView, draggingImageForItemsAtIndexPaths indexPaths: Set<IndexPath>, with event: NSEvent, offset dragImageOffset: UnsafeMutablePointer<NSPoint>) -> NSImage? {
    // 处理单个选中项（多选的话可以循环生成拼接图）
    guard let indexPath = indexPaths.first,
          let cell = collectionView.item(at: indexPath) as? YourCustomCollectionCell else {
        return nil
    }
    
    // 生成单元格的快照作为拖拽镜像
    let imageRep = cell.bitmapImageRepForCachingDisplay(in: cell.bounds)!
    cell.cacheDisplay(in: cell.bounds, to: imageRep)
    let dragImage = NSImage(size: cell.bounds.size)
    dragImage.addRepresentation(imageRep)
    
    // 设置镜像偏移，让拖拽时鼠标位置更贴合镜像中心
    let cellScreenPoint = NSPoint(x: cell.bounds.midX, y: cell.bounds.midY)
    dragImageOffset.pointee = NSPoint(
        x: event.locationInWindow.x - cell.convert(cellScreenPoint, to: nil).x,
        y: event.locationInWindow.y - cell.convert(cellScreenPoint, to: nil).y
    )
    
    return dragImage
}

注意：YourCustomCollectionCell是你的自定义单元格类，可根据实际类名替换

（3）拖拽会话开始时禁用源项目自动移动 #

在拖拽会话启动时，告诉系统不要自动隐藏源单元格：

func collectionView(_ collectionView: NSCollectionView, draggingSession session: NSDraggingSession, willBeginAtPoint screenPoint: NSPoint, forItemsAtIndexPaths indexPaths: Set<IndexPath>) {
    // 根据你的需求设置操作类型，比如Copy或Move
    session.sourceOperationMask = .copy
    // 核心：禁用源项目的自动移动，原单元格就会保持显示
    session.enablesSourceItemMovement = false
}

// 可选：根据拖拽上下文调整操作掩码
func collectionView(_ collectionView: NSCollectionView, draggingSession session: NSDraggingSession, sourceOperationMaskFor context: NSDraggingContext) -> NSDragOperation {
    switch context {
    case .withinApplication:
        return [.copy, .move] // 内部拖拽支持复制或移动
    case .outsideApplication:
        return .copy // 拖到外部只允许复制
    @unknown default:
        return []
    }
}

2. 为什么之前的方法无效？ #

你之前尝试修改sourceOperationMask没用，是因为只改操作类型没解决核心问题：系统默认会在拖拽时隐藏源单元格。只有同时自定义拖拽镜像+禁用enablesSourceItemMovement，才能让原单元格保持显示，同时显示拖拽镜像，和Finder的行为一致。

3. 额外注意事项 #

• 如果是多选拖拽，你可以在draggingImageForItemsAtIndexPaths里把多个单元格的快照拼接成一张图，模拟Finder的多选拖拽效果
• 拖拽完成后，如果是移动操作，你需要自己手动更新数据源并刷新collectionView，因为禁用了自动移动，系统不会帮你处理源项目的删除

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