如何在SwiftData中查询指定属性，避免加载大字段影响性能？

方法一：使用投影（Projection）查询 #

SwiftData支持通过投影方式只加载需要的属性，类似SQL的select指定字段。你可以定义一个只包含目标属性的结构体，然后通过FetchDescriptor指定要获取的属性和投影转换逻辑。

示例代码：
首先定义投影结构体：

// 只包含你需要的属性
struct MyDataPreview {
    let id: UUID
    let name: String // 对应原模型的name属性
}

然后在视图或数据处理逻辑中构建查询：

// 构建FetchDescriptor，指定要获取的属性并映射到投影结构体
let fetchDescriptor = FetchDescriptor<myData>(
    fetchBy: [\.id, \.name], // 明确指定要加载的属性
    projection: { MyDataPreview(id: $0.id, name: $0.name) }
)

do {
    // 执行查询，得到的是投影结构体数组，不会加载note属性
    let dataList = try modelContext.fetch(fetchDescriptor)
    // 处理数据
} catch {
    print("查询失败：\(error.localizedDescription)")
}

如果是在SwiftUI视图中，也可以直接用@Query绑定这个FetchDescriptor：

@Query(fetchDescriptor: fetchDescriptor) private var dataList: [MyDataPreview]

方法二：拆分模型，延迟加载大属性 #

如果note这类大文本属性不常用，推荐把它拆成独立的模型，通过关系关联，这样查询主模型时默认不会加载关联的大属性，需要时再手动获取。

示例代码：
拆分后的模型：

@Model
class MyData {
    var id: UUID
    var name: String
    // 其他常用属性
    // 一对一关联Note模型，默认延迟加载
    var note: Note?
}

@Model
class Note {
    var content: String // 原note属性的内容
    // 反向关联
    @Relationship(inverse: \MyData.note) var parentData: MyData?
}

查询MyData时，只会加载主模型的属性，note不会被自动加载。当需要查看note内容时，再通过myData.note触发加载即可。

两种方案对比 #

• 投影查询适合临时场景，比如列表页只需要展示基础信息，快速获取部分属性。
• 模型拆分适合长期性能优化，大属性独立存储，避免每次查询都加载冗余数据。

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