如何将UserDefaults.standard数据迁移至UserDefaults(suitName:)？

核心结论 #

可以手动把UserDefaults.standard里的数据迁移到App Group对应的UserDefaults实例里——直接切换到suitName初始化的实例，确实会丢失用户之前存在standard里的自定义数据，但不会重置你在代码里设置的默认值。之所以觉得“全部重置”，是因为App Group的UserDefaults是全新容器，没有之前存储的用户偏好，而默认值需要你主动在新容器里注册。

迁移步骤 #

• 第一步：标记迁移状态，避免重复执行
  先在App Group的UserDefaults里加个标记，确保迁移只跑一次：

  let appGroupDefaults = UserDefaults(suiteName: "你的App Group ID")!
  let hasMigratedKey = "HasMigratedUserDefaults"
  
  guard !appGroupDefaults.bool(forKey: hasMigratedKey) else {
      // 已经迁移过，直接退出
      return
  }
  

• 第二步：迁移目标数据
  推荐只迁移你需要的键（比如强调色相关的键），避免把系统自动生成的无关数据带过去：

  let standardDefaults = UserDefaults.standard
  // 替换成你实际要迁移的键名
  let keysToMigrate = ["accentColorHex", "accentColorName"]
  
  for key in keysToMigrate {
      if let value = standardDefaults.object(forKey: key) {
          appGroupDefaults.set(value, forKey: key)
      }
  }
  
  // 如果你确定要迁移所有用户自定义数据，也可以这么写（不推荐）：
  // let allStandardData = standardDefaults.dictionaryRepresentation()
  // for (key, value) in allStandardData {
  //     appGroupDefaults.set(value, forKey: key)
  // }
  

• 第三步：标记迁移完成

  appGroupDefaults.set(true, forKey: hasMigratedKey)
  appGroupDefaults.synchronize() // iOS12+系统会自动同步，手动调用是为了确保立即生效
  

后续代码规范 #

• 全局统一使用App Group的UserDefaults实例，别再混用standard，避免数据不一致。可以封装个单例方便调用：

  extension UserDefaults {
      static let appGroup: UserDefaults = {
          guard let defaults = UserDefaults(suiteName: "你的App Group ID") else {
              fatalError("初始化App Group UserDefaults失败，请检查配置")
          }
          return defaults
      }()
  }
  

• 在主App启动和Widget初始化时，都要给App Group的UserDefaults注册默认值，确保两边默认值一致：

  func setupDefaultValues() {
      let defaults = UserDefaults.appGroup
      // 替换成你的实际默认值
      let defaultValues: [String: Any] = [
          "accentColorHex": "#007AFF"
      ]
      defaults.register(defaults: defaultValues)
  }
  

误区纠正 #

• 直接用UserDefaults(suitName:)不会重置你代码里的默认值，只要你在主App和Widget里都调用了register(defaults:)，默认值就会生效。所谓的“重置”只是丢失了用户之前存在standard里的自定义设置。
• 不要盲目迁移UserDefaults.standard的所有键，它包含系统自动添加的内容（比如语言设置键），这些数据不需要共享，迁移了反而可能出问题。

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