跨平台剪贴板共享软件：macOS文件复制功能实现方案咨询

针对你的跨平台剪贴板共享需求，macOS 端推荐采用**承诺式文件 URL（Promised File URL）**配合系统剪贴板框架实现，这既符合 macOS 原生行为（和你观察到的 RDP 客户端逻辑一致），也能和 Windows/Linux 端的按需加载逻辑对齐。

核心机制说明 #

macOS 剪贴板处理文件时支持两种核心类型：

• public.file-url：直接存储本地文件的 URL，适合已存在的本地文件
• com.apple.pasteboard.promised-file-url：承诺式 URL，仅先提供文件元数据（大小、权限、文件名等），当系统（如 Finder）实际需要文件内容时，才触发数据拉取逻辑。这正是 RDP 客户端实现"延迟填充内容"的核心方式，完美匹配你的网络剪贴板场景。

具体实现步骤 #

1. 封装跨平台抽象层 #

先抽象一个统一的文件剪贴板接口，让各平台实现对齐：

protocol ClipboardFileProvider {
    func getFileMetadata() -> [String: Any] // 返回文件名、大小、权限等元数据
    func fetchFileContent() -> Data // 从网络拉取文件内容的逻辑
}

Windows 端实现该接口时映射到 IDataObject 的流读取，Linux 端映射到 Fuse 临时文件的自定义读取，macOS 端则基于系统剪贴板框架实现。

2. macOS 剪贴板写入逻辑 #

使用 NSPasteboard 写入承诺式文件 URL，关键是实现 NSPasteboardItemDataProvider 协议来处理按需数据请求：

class PromisedFileProvider: NSObject, NSPasteboardItemDataProvider {
    private let fileMeta: [String: Any]
    private let contentFetcher: () -> Data
    
    init(meta: [String: Any], contentFetcher: @escaping () -> Data) {
        self.fileMeta = meta
        self.contentFetcher = contentFetcher
        super.init()
    }
    
    // 系统触发内容请求时执行
    func pasteboard(_ pasteboard: NSPasteboard, item: NSPasteboardItem, provideDataForType type: NSPasteboard.PasteboardType) {
        guard type == .promisedFileURL else { return }
        
        // 创建临时文件路径
        let tempDir = NSTemporaryDirectory()
        let fileName = fileMeta["fileName"] as! String
        let tempFileURL = URL(fileURLWithPath: tempDir).appendingPathComponent(fileName)
        
        // 用 NSFileCoordinator 协调文件写入，确保系统进程感知变化
        let coordinator = NSFileCoordinator(filePresenter: nil)
        coordinator.coordinate(writingItemAt: tempFileURL, options: .forReplacing, error: nil) { writingURL in
            // 拉取远程内容并写入临时文件
            let content = self.contentFetcher()
            try? content.write(to: writingURL)
            
            // 设置文件元数据（权限、大小等）
            var attributes = [FileAttributeKey: Any]()
            if let fileSize = self.fileMeta["fileSize"] as? Int64 {
                attributes[.size] = fileSize
            }
            if let permissions = self.fileMeta["permissions"] as? UInt16 {
                attributes[.posixPermissions] = permissions
            }
            try? FileManager.default.setAttributes(attributes, ofItemAtPath: writingURL.path)
        }
        
        // 将临时文件URL返回给剪贴板
        item.setData(tempFileURL.dataRepresentation, forType: .promisedFileURL)
    }
}

// 写入剪贴板的调用逻辑
func writeFileToClipboard(meta: [String: Any], contentFetcher: @escaping () -> Data) {
    let pasteboard = NSPasteboard.general
    pasteboard.clearContents()
    
    let item = NSPasteboardItem()
    item.setDataProvider(PromisedFileProvider(meta: meta, contentFetcher: contentFetcher), forTypes: [.promisedFileURL])
    
    pasteboard.writeObjects([item])
}

3. NSFileCoordinator 的作用 #

NSFileCoordinator 是 macOS 用于协调文件访问的核心类，主要解决：

• 避免多个进程同时读写同一文件的冲突
• 确保 Finder、Spotlight 等系统进程能及时收到文件变化通知，正确读取最新内容
  在承诺式文件场景中，它能保证当你写入临时文件后，Finder 粘贴时能立即获取到完整内容，不会出现元数据和内容不一致的问题。

4. 跨平台对齐要点 #

• 临时文件管理：macOS 使用 NSTemporaryDirectory() 创建临时文件，和 Windows 的系统临时目录、Linux 的 Fuse 临时文件系统逻辑一致，统一上层的临时文件清理策略
• 按需加载：承诺式 URL 的延迟拉取逻辑，和 Linux Fuse 的自定义读取、Windows IStream 的按需流读取完全对齐，上层无需关心平台差异，只需实现内容拉取的抽象方法

关键行为解释 #

你观察到的 RDP 客户端现象：

• 命令行工具（如 vi）直接读取临时文件时内容为空：因为此时系统尚未触发内容拉取（只有 Finder 等图形界面操作会触发 NSPasteboardItemDataProvider 的回调）
• Finder 粘贴后内容填充：粘贴操作会触发系统调用数据提供逻辑，此时才从远程拉取内容写入临时文件

内容的提问来源于stack exchange，提问作者gao.xiangyang