如何在SwiftData中为自定义模型预加载初始数据？

首先先修正你代码里的两个小问题：

1. 模型定义中 @Model class Example: { 多了个多余的冒号，会导致编译报错；
2. 视图里的 @Query var doors: [Door] 类型不匹配，应该改成 @Query var examples: [Example]。

你之前创建静态数组的方式只是生成了内存中的对象实例，但没有把它们存入 SwiftData 的上下文，所以 @Query 根本查不到这些数据。下面是两种靠谱的预加载实现方案：

方案一：在应用启动时全局预加载（推荐） #

在 App 结构体中处理，确保预加载逻辑只执行一次，适合全局通用的初始数据：

import SwiftUI
import SwiftData

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .modelContainer(for: Example.self)
        .onAppear {
            preloadInitialData()
        }
    }

    private func preloadInitialData() {
        let container = try! ModelContainer(for: Example.self)
        let context = container.mainContext

        // 先检查数据库是否已有数据，避免重复插入
        let fetchDescriptor = FetchDescriptor<Example>()
        guard let count = try? context.fetchCount(fetchDescriptor), count == 0 else {
            return
        }

        // 插入示例数据并保存
        Example.examples.forEach { example in
            context.insert(example)
        }
        try? context.save()
    }
}

// 修正后的模型
@Model class Example {
    let name: String
    let type: String

    init(name: String, type: String) {
        self.name = name
        self.type = type
    }
}

// 保留你的静态示例数组
extension Example {
    static let examples: [Example] = [
        Example(name: "ex1", type: "red"),
        Example(name: "ex2", type: "blue")
    ]
}

方案二：在目标视图中预加载 #

适合仅在特定视图需要初始数据的场景，借助视图的环境上下文处理：

import SwiftUI
import SwiftData

struct ContentView: View {
    @Environment(\.modelContext) private var context
    @Query private var examples: [Example]

    var body: some View {
        List(examples) { example in
            VStack(alignment: .leading) {
                Text(example.name)
                    .font(.headline)
                Text(example.type)
                    .font(.subheadline)
            }
        }
        .onAppear {
            preloadInitialData()
        }
    }

    private func preloadInitialData() {
        let fetchDescriptor = FetchDescriptor<Example>()
        guard let count = try? context.fetchCount(fetchDescriptor), count == 0 else {
            return
        }

        Example.examples.forEach { context.insert($0) }
        try? context.save()
    }
}

// 修正后的模型及静态数组
@Model class Example {
    let name: String
    let type: String

    init(name: String, type: String) {
        self.name = name
        self.type = type
    }
}

extension Example {
    static let examples: [Example] = [
        Example(name: "ex1", type: "red"),
        Example(name: "ex2", type: "blue")
    ]
}

核心逻辑说明：

• 必须通过 modelContext.insert() 将对象存入 SwiftData 的数据库上下文；
• 每次预加载前先查询数据量，避免重复插入；
• 调用 context.save() 完成数据持久化，这样 @Query 才能查询到这些数据。

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