未勾选CoreData创建的iOS项目中如何正确使用NSEntityDescription

问题根因 #

你遇到的「隐式解包可选值时意外发现nil」报错，基本是以下两个原因之一：

1. managedContext 本身为nil，要么是AppDelegate的persistentContainer属性没有正确声明，要么是UIApplication的delegate转AppDelegate失败
2. 系统找不到ScoreData实体，要么是NSPersistentContainer的名称和你的.xcdatamodeld数据模型文件名不一致，要么是实体名拼写/大小写错误，要么是数据模型文件没有加入当前APP的Target成员中

第一步：基础配置校验 #

• 打开你的.xcdatamodeld文件，确认文件名和你NSPersistentContainer(name: "BoschBrooke_4.1_MemoryGame")里的名称完全一致，包括大小写
• 选中该数据模型文件，在右侧文件检查器的「Target Membership」栏，确认你的APP主目标是勾选状态
• 确认AppDelegate里已经正确声明persistentContainer属性，完整的声明必须写在AppDelegate类内部：

// AppDelegate.swift 内的完整声明
lazy var persistentContainer: NSPersistentContainer = {
    let container = NSPersistentContainer(name: "BoschBrooke_4.1_MemoryGame")
    container.loadPersistentStores(completionHandler: { (storeDescription, error) in
        if let error = error as NSError? {
            fatalError("Unresolved error \(error), \(error.userInfo)")
        }
    })
    return container
}()

第二步：修正ViewController代码 #

替换原有的强制解包逻辑，避免崩溃，同时给出完整的存储实现：

import CoreData // 顶部记得导入CoreData框架

class ViewController: UIViewController {
    var trackTapCount = 0
    // 不要用隐式解包，改成普通可选
    private var managedContext: NSManagedObjectContext?
    var storedInitials: String = ""
    var storedTime: String = ""

    override func viewDidLoad() {
        super.viewDidLoad()
        // 安全获取context
        guard let appDelegate = UIApplication.shared.delegate as? AppDelegate else {
            print("获取AppDelegate失败")
            return
        }
        managedContext = appDelegate.persistentContainer.viewContext
    }

    // 游戏结束时调用该方法存储高分
    func saveGameScore() {
        guard let context = managedContext else { return }
        // 更简便的实体初始化方式，不需要手动获取entityDescription
        guard let scoreData = NSEntityDescription.insertNewObject(forEntityName: "ScoreData", into: context) as? NSManagedObject else {
            print("创建ScoreData实体失败，请检查实体名是否正确")
            return
        }
        // 给实体属性赋值
        scoreData.setValue(storedInitials, forKey: "initials")
        scoreData.setValue(trackTapCount, forKey: "tapCount")
        scoreData.setValue(storedTime, forKey: "timeComplete")
        scoreData.setValue(Date(), forKey: "timestamp") // 建议直接存Date类型，后续排序筛选更方便，如果你坚持用String可以替换为对应字符串值

        // 持久化保存到本地
        do {
            try context.save()
            print("高分保存成功")
        } catch let error as NSError {
            print("保存失败：\(error), \(error.userInfo)")
        }
    }
}

额外优化建议 #

• 你可以在数据模型编辑器中，选中ScoreData实体，把右侧「Data Model Inspector」中的Codegen选项改为「Class Definition」，Xcode会自动生成对应的实体类，不需要用KVC的setValue方式赋值，直接用scoreData.initials = storedInitials这种点语法赋值更安全，不会出现拼写错误
• 普通UI场景下的CoreData操作直接用viewContext即可，不需要开背景上下文，只有大批量数据操作时才需要用背景上下文避免卡住UI

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