Swift Academy · 课时

Core Data 堆栈：设置 NSPersistentContainer

Q: 「Core Data 堆栈：设置 NSPersistentContainer」这节课中我会学到什么？

在 SwiftUI 应用中设置持久化容器、上下文和协调器。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

在 SwiftUI 应用中设置持久化容器、上下文和协调器。

第 1 / 4 课13 个步骤

Core Data 堆栈：设置 NSPersistentContainer 是 CoddyKit 上的免费 Swift Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。

Core Data 概览

Core Data 是 Apple 的对象图和持久化框架。它通过面向对象的 API 管理 SQLite（或其他存储）。

import CoreData
// Key classes: NSPersistentContainer, NSManagedObjectContext
// NSManagedObject, NSFetchRequest

创建 NSPersistentContainer

使用您的 .xcdatamodeld 模型名称初始化 NSPersistentContainer，然后加载持久化存储。

let container = NSPersistentContainer(name: "MyModel")
container.loadPersistentStores { desc, error in
  if let error { fatalError("Core Data failed: \(error)") }
}

持久化控制器模式

将容器封装在单例（或可注入的）PersistenceController 结构体中，以便应用各处清晰地访问。

struct PersistenceController {
  static let shared = PersistenceController()
  let container: NSPersistentContainer
  init() {
    container = NSPersistentContainer(name: "MyModel")
    container.loadPersistentStores { _, error in
      if let error { fatalError("\(error)") }
    }
  }
}

viewContext 与 backgroundContext

viewContext 是用于界面的主线程上下文。对于繁重的操作，请使用 newBackgroundContext()。

let viewCtx = PersistenceController.shared.container.viewContext
let bgCtx = PersistenceController.shared.container.newBackgroundContext()

创建托管对象

使用 NSEntityDescription.insertNewObject 或生成的类初始化器插入新对象。

let item = Item(context: viewCtx)
item.timestamp = Date()
try? viewCtx.save()

获取对象

使用 NSFetchRequest，结合谓词和排序描述符查询 Core Data 对象。

let request: NSFetchRequest<Item> = Item.fetchRequest()
request.sortDescriptors = [NSSortDescriptor(key: "timestamp", ascending: false)]
let items = try? viewCtx.fetch(request)

保存上下文

始终调用 context.save() 以持久化更改。在生产代码中，请使用 do-catch 进行处理。

do {
  try viewCtx.save()
} catch {
  print("Save failed: \(error)")
  viewCtx.rollback()
}

使用 @FetchRequest 集成 SwiftUI

在 SwiftUI 视图中使用 @FetchRequest，让界面在 Core Data 发生更改时自动更新。

struct ItemList: View {
  @FetchRequest(
    sortDescriptors: [SortDescriptor(\Item.timestamp, order: .reverse)]
  ) var items: FetchedResults<Item>
  var body: some View {
    List(items) { Text($0.timestamp!.formatted()) }
  }
}

将 viewContext 注入 SwiftUI

通过 SwiftUI 环境传入 viewContext，这样视图就可以读取和写入 Core Data。

@main
struct MyApp: App {
  let persistence = PersistenceController.shared
  var body: some Scene {
    WindowGroup {
      ContentView()
        .environment(\.managedObjectContext, persistence.container.viewContext)
    }
  }
}

删除对象

调用 context.delete(object)，然后保存，以永久删除对象。

viewCtx.delete(item)
try? viewCtx.save()

用于测试的内存存储

使用内存存储，避免在单元测试期间操作磁盘。

let desc = NSPersistentStoreDescription()
desc.type = NSInMemoryStoreType
container.persistentStoreDescriptions = [desc]
container.loadPersistentStores { _, _ in }

快速检查

对于由界面驱动的 Core Data 读取和写入，应使用 NSPersistentContainer 的哪个上下文？

在交互式课程中回答

课程回顾

使用 NSPersistentContainer 设置 Core Data，加载存储，并将其封装在 PersistenceController 中。在主线程上使用 viewContext，并使用 newBackgroundContext() 执行繁重的工作。通过 @FetchRequest 和托管对象上下文环境键与 SwiftUI 集成。

免费开始

用 AI 导师学习 Swift — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 122
课程: 409

免费开始学习查看完整课程

常见问题解答

「Core Data 堆栈：设置 NSPersistentContainer」课时是免费的吗？

是的 — 「Core Data 堆栈：设置 NSPersistentContainer」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。

「Core Data 堆栈：设置 NSPersistentContainer」这节课中我会学到什么？

在 SwiftUI 应用中设置持久化容器、上下文和协调器。你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「Core Data 堆栈：设置 NSPersistentContainer」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Swift Academy