macOS应用实现TextField拖拽接收文件时performDragOperation不触发求助

问题根因 #

你遇到的performDragOperation不触发的问题，本质是漏实现了draggingUpdated方法：NSView的默认draggingUpdated实现会返回NSDragOperationNone，拖拽进入控件后只要鼠标发生移动，系统就会判定你不接受当前拖拽，因此松开鼠标时不会触发后续的拖拽提交方法。
另外NSTextField默认的文本编辑拖拽行为也可能和自定义拖拽逻辑冲突，可根据需求调整可编辑属性。

macOS 控件接收拖拽的完整流程 #

• 控件注册支持的拖拽类型（你已经在awakeFromNib里正确实现）
• 拖拽进入控件范围：触发draggingEntered，校验粘贴板内容后返回支持的拖拽操作
• 拖拽在控件范围内移动：触发draggingUpdated，需要返回和draggingEntered一致的操作类型，否则系统会判定拖拽无效
• 拖拽松开在控件范围内：先触发prepareForDragOperation，返回true后再触发performDragOperation执行最终的拖拽处理
• 拖拽移出控件范围：触发draggingExited做清理操作

修复后的完整代码 #

import Cocoa

class DropTextField: NSTextField {
    // 只接收文件URL保留.fileURL类型即可，需要支持普通网络URL可加回.URL
    private let dragTypes: [NSPasteboard.PasteboardType] = [.fileURL]

    override func awakeFromNib() {
        super.awakeFromNib()
        registerForDraggedTypes(dragTypes)
        // 如果不需要用户手动输入文本，建议设置为false避免编辑拖拽冲突
        // isEditable = false
    }
    
    override func draggingEntered(_ sender: NSDraggingInfo) -> NSDragOperation {
        print("dragging entered")
        // 先校验粘贴板是否有合法的文件URL，避免接受无效拖拽
        let pasteboard = sender.draggingPasteboard
        guard pasteboard.canReadObject(forClasses: [NSURL.self], options: [.urlReadingFileURLsOnly: true]) else {
            return []
        }
        return .copy
    }
    
    // 必须实现这个方法，返回支持的拖拽操作
    override func draggingUpdated(_ sender: NSDraggingInfo) -> NSDragOperation {
        return .copy
    }
    
    override func prepareForDragOperation(_ sender: NSDraggingInfo) -> Bool {
        return true
    }
    
    override func performDragOperation(_ sender: NSDraggingInfo) -> Bool {
        print("drag operation triggered")
        let pasteboard = sender.draggingPasteboard
        // 读取拖拽的文件URL
        guard let urls = pasteboard.readObjects(forClasses: [NSURL.self], options: [.urlReadingFileURLsOnly: true]) as? [URL] else {
            return false
        }
        // 拿到URL后的处理逻辑示例：把第一个文件路径显示到TextField
        if let firstFilePath = urls.first?.path {
            stringValue = firstFilePath
        }
        return true
    }
}

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