面向macOS 10.14的Core Data外部文件管理（支持Undo/Redo）示例代码请求及问题咨询

我完全懂你这种“打地鼠”式修bug的痛苦——用Core Data绑定外部文件还得兼顾Undo/Redo，尤其是子上下文的状态同步，确实有一堆容易踩的坑。核心问题其实是你之前的实现把文件操作的状态依赖于上下文事件（比如didSave、awake(fromSnapshotEvents:)），而没有把状态完全内聚到Core Data实体本身。下面是一套成熟的解决方案，附带可复用的示例代码：

核心思路 #

把文件的操作状态（删除/恢复/重命名）直接存在File实体的属性里，让实体自己“记住”所有必要的操作信息，不管是子上下文还是父上下文，都能通过实体属性直接获取状态，不用再猜上下文的状态变化。

1. 扩展File实体，增加状态属性 #

首先给你的File实体新增几个属性，用来记录文件操作的关键状态：

// 先定义操作类型枚举
enum FileOperationType: Int16 {
    case none = 0
    case create
    case delete
    case rename
}

extension File {
    // 原有属性
    @NSManaged var filename: String
    
    // 新增状态属性
    @NSManaged var isDeleted: Bool // 标记是否逻辑删除（实体不删，文件移回收站）
    @NSManaged var originalFilepath: String? // 记录删除前的路径/回收站路径
    @NSManaged var operationTypeRaw: Int16 // 存储FileOperationType的原始值
    
    // 封装枚举属性，方便调用
    var operationType: FileOperationType {
        get { FileOperationType(rawValue: operationTypeRaw) ?? .none }
        set { operationTypeRaw = newValue.rawValue }
    }

    // 重构后的filepath属性，根据当前状态返回正确URL
    @objc var filepath: URL? {
        willAccessValue(forKey: #keyPath(File.filepath))
        defer { didAccessValue(forKey: #keyPath(File.filepath)) }
        
        // 如果是已删除状态，返回回收站里的路径
        if isDeleted {
            return originalFilepath.flatMap(URL.init(fileURLWithPath:))
        }
        
        // 缓存命中直接返回
        guard primitiveValue(forKey: #keyPath(File.filepath)) == nil else {
            return primitiveValue(forKey: #keyPath(File.filepath)) as? URL
        }
        
        // 构造当前有效路径并缓存
        let url = file_directory.appendingPathComponent(filename)
        setPrimitiveValue(url, forKey: #keyPath(File.filepath))
        return url
    }
}

2. 用自定义方法绑定文件操作与Undo/Redo #

把所有文件操作（删除/恢复/重命名）封装成实体的方法，确保每个操作都和Core Data属性修改绑定在同一个Undo事务里：

extension File {
    /// 删除文件并记录状态（支持Undo）
    func deleteFile(with undoManager: UndoManager?) throws {
        guard !isDeleted else { return }
        
        // 1. 先记录原始状态
        guard let currentURL = filepath else { throw NSError(domain: "FileError", code: -1, userInfo: [NSLocalizedDescriptionKey: "文件路径不存在"]) }
        originalFilepath = currentURL.path
        isDeleted = true
        operationType = .delete
        
        // 2. 执行文件移动到回收站操作
        do {
            let trashURL = try FileManager.default.trashItem(at: currentURL, resultingItemURL: nil)
            // 更新为回收站实际路径（如果需要后续恢复）
            originalFilepath = trashURL.path
        } catch {
            // 操作失败回滚状态
            isDeleted = false
            originalFilepath = nil
            operationType = .none
            throw error
        }
        
        // 3. 注册Undo操作
        undoManager?.registerUndo(withTarget: self) { [weak self] file in
            try? file.restoreFile(with: undoManager)
        }
    }

    /// 恢复已删除的文件（支持Redo）
    func restoreFile(with undoManager: UndoManager?) throws {
        guard isDeleted, let trashURL = originalFilepath.flatMap(URL.init(fileURLWithPath:)) else { return }
        
        // 1. 恢复文件到原路径
        let targetURL = file_directory.appendingPathComponent(filename)
        do {
            try FileManager.default.moveItem(at: trashURL, to: targetURL)
            // 2. 重置状态
            isDeleted = false
            originalFilepath = nil
            operationType = .none
        } catch {
            throw error
        }
        
        // 3. 注册Redo操作
        undoManager?.registerUndo(withTarget: self) { [weak self] file in
            try? file.deleteFile(with: undoManager)
        }
    }
}

3. 子上下文与父上下文的状态同步 #

因为所有操作状态都存在实体里，子上下文保存到父上下文后，父上下文的File实体自然会继承这些状态。撤销/重做操作时，直接调用实体的方法即可，不用再传递额外状态：

// 子上下文处理表单操作示例
let childContext = NSManagedObjectContext(concurrencyType: .mainQueueConcurrencyType)
childContext.parent = mainContext

// 删除文件（在子上下文里）
if let fileToDelete = childContext.object(with: fileObjectID) as? File {
    try? fileToDelete.deleteFile(with: childContext.undoManager)
}

// 保存子上下文到父上下文
try? childContext.save()

// 父上下文撤销操作示例
if mainContext.undoManager?.canUndo ?? false {
    mainContext.undoManager?.undo()
    // 或者直接找到对应实体调用恢复方法
    if let restoredFile = mainContext.object(with: fileObjectID) as? File {
        try? restoredFile.restoreFile(with: mainContext.undoManager)
    }
}

4. 简化上下文事件处理 #

现在你可以抛弃didSave和awake(fromSnapshotEvents:)里复杂的状态判断，只需要在上下文保存时做简单的校验：

extension NSManagedObjectContext {
    override func save() throws {
        // 可选：校验所有File实体的状态和实际文件是否一致
        let fileFetch = File.fetchRequest()
        let files = try fetch(fileFetch)
        for file in files {
            if file.isDeleted {
                guard let trashURL = file.originalFilepath.flatMap(URL.init(fileURLWithPath:)) else {
                    file.isDeleted = false
                    file.originalFilepath = nil
                    continue
                }
                if !FileManager.default.fileExists(atPath: trashURL.path) {
                    file.isDeleted = false
                    file.originalFilepath = nil
                }
            }
        }
        try super.save()
    }
}

关键注意事项 #

• QLPreviewItem适配：直接返回filepath属性即可，它会根据isDeleted状态自动返回回收站路径或原路径，完全满足QLPreviewItem的URL要求。
• 并发安全：如果使用私有队列上下文，文件操作必须放在对应队列里执行（用performAndWait/perform包裹）。
• 错误回滚：所有文件操作失败时，一定要回滚Core Data实体的状态，避免实体状态和实际文件状态不一致。
• 永久清理：如果需要彻底删除文件（比如用户确认清空回收站），可以新增一个permanentlyDelete()方法，直接删除文件并移除实体。

这种方案把所有状态内聚到实体本身，彻底避免了依赖上下文状态判断带来的边缘问题，能覆盖你提到的子上下文Undo/Redo、状态同步等场景。

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