SwiftData：如何将@Query模型数组传递至子视图并解决绑定报错？

1. 解决'$projects不在作用域内'的错误 #

@Query返回的是只读、自动更新的数据集，它并不是@State/@Binding这类可绑定属性包装器，因此没有对应的$投影属性。但你无需绑定整个数组——因为Project是用@Model标记的类，它本身是可观察对象，其属性直接支持绑定修改。

修改代码如下：

修改ProjectView #

struct ProjectView: View {
    // 直接接收只读数组，无需@Binding
    let projects: [Project]

    var body: some View {
        ScrollView {
            VStack {
                // 遍历数组，直接绑定Project的属性
                ForEach(projects) { project in
                    TextField("Project Name", text: $project.name)
                        .padding()
                        .textFieldStyle(RoundedBorderTextFieldStyle())
                }
            }
            .padding()
        }
    }
}

修改ContentView的调用 #

// 直接传递projects，而非$projects
ProjectView(projects: projects)

修改后，TextField的内容修改会自动同步到SwiftData数据库，因为@Model的属性修改会被自动追踪并持久化。

2. SwiftData的核心价值：不止于只读查询 #

@Query确实是用来获取数据的，但SwiftData的核心优势体现在：

• 自动持久化与同步：修改@Model实例的属性会自动写入数据库，简单场景下无需手动调用上下文保存，也不用像Core Data那样手动管理托管对象状态。
• SwiftUI深度集成：@Query自动监听数据变化，数据更新时视图自动刷新；@Model的属性直接支持$绑定，无需额外观察对象。
• 类型安全的查询：查询语法完全基于Swift类型，避免Core Data中字符串键路径的错误，同时支持过滤、排序、分页等复杂操作。
• 简化的生命周期管理：模型上下文自动处理对象的创建、保存、销毁，无需手动搭建持久化栈。
• 关系与嵌套支持：可轻松定义模型间的一对一、一对多关系，SwiftData会自动处理关联数据的加载与持久化。

3. 通过环境值传递数组的实现 #

如果需要在多个子视图中共享同一个projects数据集，可以通过自定义环境键实现：

定义环境键 #

extension EnvironmentValues {
    var projects: [Project] {
        get { self[ProjectsEnvironmentKey.self] }
        set { self[ProjectsEnvironmentKey.self] = newValue }
    }
}

struct ProjectsEnvironmentKey: EnvironmentKey {
    static let defaultValue: [Project] = []
}

在父视图中注入环境值 #

struct ContentView: View {
    @Query var projects: [Project]
    // ...其他代码

    var body: some View {
        VStack {
            // ...
            ProjectView()
                .environment(\.projects, projects)
        }
    }
}

在子视图中读取环境值 #

struct ProjectView: View {
    @Environment(\.projects) var projects

    var body: some View {
        // 用法和直接传参一致
        ScrollView {
            VStack {
                ForEach(projects) { project in
                    TextField("Project Name", text: $project.name)
                        .padding()
                }
            }
        }
    }
}

如果只是单个子视图使用，直接传参的方式会更简洁直观。

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