使用NSPersistentCloudKitContainer接入CloudKit后仪表盘无CD_前缀记录类型

• Core Data实体未开启CloudKit同步配置
  打开.xcdatamodeld模型文件，选中所有需要同步的实体，在右侧数据检查器面板中确认Use with CloudKit选项已勾选，未勾选的实体不会被NSPersistentCloudKitContainer纳入同步范围，也不会在CloudKit控制台生成CD_前缀的记录类型。
• 持久化存储配置缺失必填参数
  初始化NSPersistentCloudKitContainer时，需要给持久化存储描述开启两项核心配置：

  // 开启历史追踪，用于同步差异计算
  storeDescription.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)
  // 开启远程变更通知，用于接收云端同步回调
  storeDescription.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
  // 绑定正确的CloudKit容器ID
  storeDescription.cloudKitContainerOptions = NSPersistentCloudKitContainerOptions(containerIdentifier: "你的容器ID")
  

  缺少任意一项配置都会导致同步逻辑不生效。
• iCloud权限未正常获取
  应用首次启动时会弹出iCloud使用权限申请弹窗，若未点击允许，系统会限制应用访问iCloud，应用也不会出现在iCloud使用列表中。可在设备「设置」-「[你的账号]」-「iCloud」-「显示全部」中查看对应应用的iCloud开关是否开启，同时确认设备的iCloud Drive功能处于启用状态。
• 环境/容器标识不匹配
  确认Xcode中Target的Signing & Capabilities面板勾选的CloudKit容器ID，与开发者后台创建的容器ID完全一致；同时确认当前运行的是Development环境，未误切到Production环境，两类环境的存储数据完全隔离。
• 本地变更未持久化触发同步
  NSPersistentCloudKitContainer只会同步已经持久化到本地存储的改动，创建托管对象后必须调用NSManagedObjectContext.save()方法保存本地变更，才会触发后续的云端同步逻辑。可在Xcode控制台开启CoreData与CloudKit日志输出，搜索报错信息直接定位具体同步失败原因。

内容的提问来源于stack exchange，提问作者Germán