SwiftData结合CloudKit：检测同步完成与待同步变更的方法

针对你提到的两个技术问题，结合数据去重的需求，给出实际可落地的实现方法：

1. 检测CloudKit同步完成新数据的时机 #

SwiftData 对接 CloudKit 时，主要靠 CloudKitSyncEngine 管控同步流程，你可以通过它的代理精准捕获同步完成的节点：

• 先从你的 ModelContainer 或 ModelContext 里拿到配置好的 CloudKitSyncEngine 实例
• 设置代理并实现 cloudKitSyncEngine(_:didFinishSyncingWith:) 方法——每一轮同步（不管是拉取其他设备的新数据，还是推送本地变更到云端）完成后，这个方法都会触发。如果同步没出错，就可以在这里执行去重逻辑。
• 另外也可以监听 ModelContext 的 objectsDidChange 通知，但要通过变更来源过滤：只有当变更来自CloudKit同步时，才触发去重。示例代码：

NotificationCenter.default.addObserver(forName: .NSManagedObjectContextObjectsDidChange, object: modelContext, queue: .main) { note in
    guard let transaction = note.userInfo?[NSManagedObjectContextTransactionContextKey] as? TransactionContext,
          transaction.source == .cloudKitSync else {
        return
    }
    // 处理同步过来的新数据，执行去重操作
}

2. 检测是否存在未同步的变更 #

直接用 CloudKitSyncEngine 的 hasPendingChanges 属性就能搞定：

• 这个属性会返回布尔值，告诉你当前有没有已经保存到本地但还没同步到CloudKit的变更。
• 你可以在App启动、用户手动触发同步时检查这个属性，判断是否需要等同步完成再做后续操作。
• 也可以监听 CloudKitSyncEngine 的 syncStatusDidChange 通知，实时同步状态变化——比如从 .pending 变成 .idle 时，就说明所有待同步的变更都处理完了。

数据去重的实践建议 #

结合你的需求，推荐两种实现思路：

• 同步完成自动去重：在 cloudKitSyncEngine(_:didFinishSyncingWith:) 方法里，确认同步无错误后，执行去重逻辑。去重时一定要基于自定义的唯一标识（比如给模型加个 uuid 字段）来判断重复，别误删有效数据。
• 启动时等待同步完成：App启动阶段，先检查 CloudKitSyncEngine 的 syncStatus，如果处于同步中（.syncing），就等同步完成（通过代理或通知监听状态切换到 .idle），再加载数据并去重，确保用户看到的是最新的同步后数据。

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