如何将现有UIKit Core Data项目迁移至SwiftUI且保留用户数据

要在全新SwiftUI项目中保留原UIKit项目的Core Data数据，核心是让新项目的Core Data配置与旧项目完全对齐，确保系统能找到并复用已有的持久化存储文件。以下是具体步骤和注意事项：

1. 复用原Core Data的核心配置 #

复制数据模型文件 #

直接把旧UIKit项目中的.xcdatamodeld文件复制到新项目中，确保：

• 所有实体、属性、关系、约束和旧项目完全一致
• 模型的版本配置（如果有）完整保留，当前版本设置和旧项目相同

匹配持久化容器与存储路径 #

SwiftUI默认的PersistenceController需要调整，保证容器名称、存储URL和旧项目一致：

class PersistenceController: ObservableObject {
    static let shared = PersistenceController()
    let container: NSPersistentContainer

    init(inMemory: Bool = false) {
        // 容器名称必须和旧UIKit项目的NSPersistentContainer名称一致
        container = NSPersistentContainer(name: "YourOldDataModelName")
        
        if inMemory {
            container.persistentStoreDescriptions.first!.url = URL(fileURLWithPath: "/dev/null")
        } else {
            // 指向旧项目使用的存储文件路径（默认在Documents目录）
            let docsDir = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
            let storeURL = docsDir.appendingPathComponent("YourOldStoreName.sqlite")
            container.persistentStoreDescriptions.first!.url = storeURL
        }
        
        // 开启自动迁移（如果需要兼容模型小版本变化）
        container.persistentStoreDescriptions.first!.shouldMigrateStoreAutomatically = true
        container.persistentStoreDescriptions.first!.shouldInferMappingModelAutomatically = true
        
        container.loadPersistentStores(completionHandler: { (_, error) in
            if let error = error as NSError? {
                fatalError("Core Data加载失败: \(error), \(error.userInfo)")
            }
        })
    }
}

这里的关键是：

• NSPersistentContainer的名称必须和旧项目初始化时的名称一致
• 存储文件的名称（比如YourOldStoreName.sqlite）要和旧项目的持久化描述中的文件名完全匹配

2. 处理模型版本与迁移 #

如果旧项目使用了Core Data模型版本化（比如迭代过实体结构）：

• 把所有历史版本的.xcdatamodel文件都复制到新项目的.xcdatamodeld包中
• 在Xcode中选中.xcdatamodeld文件，确保当前版本的设置和旧项目一致
• 开启自动迁移配置（上面代码中的两个shouldMigrate参数），Core Data会自动处理兼容的模型变化（如新增可选属性、新增实体）的轻量级迁移

3. 本地测试数据迁移 #

开发阶段验证数据是否能正确加载：

1. 通过Xcode的「Devices and Simulators」窗口，找到旧UIKit App的容器，导出Documents目录下的三个文件：YourOldStoreName.sqlite、YourOldStoreName.sqlite-shm、YourOldStoreName.sqlite-wal
2. 把这三个文件导入到SwiftUI新项目的测试设备/模拟器的Documents目录中
3. 运行新项目，检查数据是否完整加载，增删改查功能是否正常

4. 发布上线的关键注意事项 #

• Bundle ID必须一致：新项目的CFBundleIdentifier要和旧UIKit项目完全相同，否则系统会视为独立App，无法访问原数据目录
• 升级测试：发布前一定要做完整的版本升级测试——安装旧版本App并生成测试数据，再安装新版本，验证数据是否完整保留
• 避免破坏性修改：如果必须修改数据模型，确保只做Core Data支持的轻量级迁移操作；如果是重量级迁移（如删除属性、修改约束），需要手动编写映射模型

5. 可选：渐进式迁移（替代全新重构） #

如果不想一次性完全重构，可以在原UIKit项目中逐步引入SwiftUI：

• 用UIHostingController将SwiftUI视图嵌入到UIKit界面中
• 直接复用原项目的Core Data栈，无需额外配置，数据自然保留
• 等所有功能迁移完成后，再整理项目结构为纯SwiftUI项目

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