第 2 章：创建第一个 SwiftData 应用

初始化 ModelContainer

什么是 ModelContainer？

ModelContainer 是 SwiftData 的核心组件之一，负责管理数据模型的持久化存储。它相当于一个数据库容器，封装了底层存储的配置和连接细节。通过 ModelContainer，开发者可以轻松设置数据存储的位置（如磁盘或内存）、配置迁移选项以及管理数据模型的版本。

基本初始化方式

最简单的初始化方式是直接传入数据模型类型：

import SwiftData

@main
struct MyApp: App {
    // 初始化 ModelContainer，指定数据模型类型
    let container = try! ModelContainer(for: TodoItem.self)
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        // 将 container 注入到环境中
        .modelContainer(container)
    }
}

多模型初始化

如果你的应用需要管理多个数据模型，可以通过数组传递：

let container = try! ModelContainer(for: [TodoItem.self, Category.self, User.self])

配置存储选项

ModelContainer 支持多种配置方式：

  1. 内存存储（测试用）
    数据仅在内存中保留，应用退出后消失：

    let config = ModelConfiguration(inMemory: true)
let container = try! ModelContainer(for: TodoItem.self, configurations: config)

  2. 自定义文件路径
    指定 SQLite 数据库的存储位置：

    let url = URL.documentsDirectory.appending(path: "mydata.sqlite")
let config = ModelConfiguration(url: url)
let container = try! ModelContainer(for: TodoItem.self, configurations: config)

  3. 关闭自动保存
    默认情况下 SwiftData 会自动保存更改，可以手动关闭：

    let config = ModelConfiguration(allowsSave: false)

错误处理

初始化可能抛出错误（如磁盘权限问题），建议使用 do-catch：

do {
    let container = try ModelContainer(for: TodoItem.self)
    // 使用 container
} catch {
    print("初始化 ModelContainer 失败: \(error.localizedDescription)")
}

与 SwiftUI 集成

通过 .modelContainer() 修饰符将容器注入视图层级后：

  • 所有子视图可通过 @Environment(\.modelContext) 获取关联的 ModelContext
  • @Query 会自动使用该容器的配置

调试提示

如果遇到初始化问题，可以启用 Core Data 调试日志（SwiftData 底层使用 Core Data）：

  1. 编辑 Xcode 项目 Scheme
  2. 在 "Arguments" 中添加环境变量：
    -com.apple.CoreData.SQLDebug 1
    -com.apple.CoreData.Logging.stderr 1

这将输出详细的 SQL 语句和存储操作日志。

下一步

初始化 ModelContainer 后，接下来可以：

  1. 通过 ModelContext 操作数据（第 2.4 节）
  2. 在 SwiftUI 视图中使用 @Query（第 5.1 节）

这个 Markdown 内容包含：
- 核心概念解释
- 多种初始化方式的代码示例
- 配置选项说明
- 错误处理建议
- 调试技巧
- 与其他章节的衔接提示
格式清晰，适合作为技术文档使用。
Last Updated::