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

数据预览与调试

在开发 SwiftData 应用时，能够实时预览和调试数据是至关重要的。本节将介绍如何利用 Xcode 提供的工具来检查数据状态、调试数据操作以及验证数据模型的正确性。

1. 使用 Xcode 的 Core Data 调试工具

虽然 SwiftData 是 Core Data 的现代化封装，但许多 Core Data 的调试工具仍然适用：

// 启用 SQL 调试输出（在启动参数中添加）
-com.apple.CoreData.SQLDebug 1
-com.apple.CoreData.Logging.stderr 1

这些参数会打印出 SwiftData 底层执行的 SQL 语句，帮助你理解数据操作的实际执行过程。

2. 预览数据模型

在 SwiftUI 预览中直接显示 SwiftData 数据：

#Preview {
    let config = ModelConfiguration(isStoredInMemoryOnly: true)
    let container = try! ModelContainer(for: TodoItem.self, configurations: config)
    
    // 添加测试数据
    let context = container.mainContext
    let item = TodoItem(title: "测试事项", isCompleted: false)
    context.insert(item)
    
    return TodoListView()
        .modelContainer(container)
}

关键点：

  • 使用 isStoredInMemoryOnly: true 创建临时内存存储
  • 在预览中预先填充测试数据
  • 确保预览视图绑定了相同的 ModelContainer

3. 打印调试信息

在代码中添加调试输出：

// 打印所有待办事项
let todos = try context.fetch(FetchDescriptor<TodoItem>())
print("当前存储的待办事项：")
todos.forEach { print("- \($0.title) (\($0.isCompleted ? "已完成" : "未完成"))") }

// 检查上下文是否有未保存的更改
print("上下文有未保存的更改：\(context.hasChanges)")

4. 使用 ModelContext 的调试方法

// 获取所有已注册对象
let registeredObjects = context.registeredObjects
print("已注册对象数量：\(registeredObjects.count)")

// 强制立即保存并检查错误
do {
    try context.save()
    print("保存成功")
} catch {
    print("保存失败：\(error.localizedDescription)")
}

5. 可视化调试技巧

  1. 在 SwiftUI 中添加调试视图：
struct DebugView: View {
    @Environment(\.modelContext) private var context
    
    var body: some View {
        VStack {
            Text("数据库状态")
            Text("待办事项数量：\(countTodos())")
            Button("打印所有数据") { printAllTodos() }
        }
    }
    
    func countTodos() -> Int {
        (try? context.fetchCount(FetchDescriptor<TodoItem>())) ?? 0
    }
    
    func printAllTodos() {
        let todos = (try? context.fetch(FetchDescriptor<TodoItem>())) ?? []
        todos.forEach { print($0) }
    }
}
  1. 使用断点调试：
    • 在 modelContext 操作处设置断点
    • 检查 ModelContext 的状态变化

6. 常见调试场景

问题类型调试方法
数据不显示检查 @Query 是否正确定义，验证数据是否成功插入
保存失败检查 do-catch 块，验证模型约束
UI 不更新确认 @Model 对象是可变类型，属性标记为 var
性能问题使用 Instruments 的 Core Data 模板进行分析

7. 调试最佳实践

  1. 始终在开发阶段启用调试输出
  2. 为复杂操作添加日志记录
  3. 使用内存存储进行快速测试
  4. 编写单元测试验证数据操作
  5. 定期检查控制台输出的 Core Data 警告

通过以上方法，你可以有效地预览和调试 SwiftData 应用程序，确保数据层按预期工作，并及时发现和解决潜在问题。

Last Updated::