SwiftData中@Query变量绑定报错：找不到$categories作用域求解决

问题场景 #

实现支持拖拽排序的流式布局列表时，使用Core Data的@Query获取categories数组，在给自定义DropDelegate传递items: $categories参数时，出现错误：Cannot find '$categories' in scope。

问题原因 #

@Query是Core Data提供的属性包装器，它返回的是只读的查询结果数组，并非可绑定的Binding类型。Core Data的查询结果由框架自动管理，不能直接通过$前缀获取绑定来修改数组结构，必须通过Core Data的上下文修改实体属性来实现排序更新。

解决方案 #

核心思路是给Category实体添加排序属性，通过修改并持久化该属性来维护顺序，让@Query自动监听变化更新UI。

步骤1：给Category实体添加排序属性 #

在Core Data模型编辑器中，给Category添加一个Int32类型的属性（比如orderIndex），用于记录每个分类的排序位置。

步骤2：修改@Query按排序属性排序 #

// 按orderIndex升序查询分类
@Query(sort: \Category.orderIndex) var categories: [Category]

步骤3：重构DropDelegate逻辑 #

不再直接操作数组，而是通过修改实体的orderIndex并保存上下文来实现排序：

struct MyDropDelegate: DropDelegate {
    let item: Category
    let draggedItem: Binding<Category?>
    let context: NSManagedObjectContext

    func dropEntered(info: DropInfo) {
        guard let dragged = draggedItem.wrappedValue, dragged != item else { return }

        // 临时交换拖拽项和目标项的索引
        let tempIndex = dragged.orderIndex
        dragged.orderIndex = item.orderIndex
        item.orderIndex = tempIndex

        // 重新分配所有分类的索引，确保顺序连续（避免索引混乱）
        for (index, category) in categories.enumerated() {
            category.orderIndex = Int32(index)
        }

        // 保存上下文，触发UI更新
        do {
            try context.save()
        } catch {
            print("排序保存失败：\(error.localizedDescription)")
        }
    }

    func performDrop(info: DropInfo) -> Bool {
        draggedItem.wrappedValue = nil // 清空拖拽状态
        return true
    }
}

步骤4：在View中使用DropDelegate #

通过@Environment获取Core Data上下文，传递给DropDelegate：

@Environment(\.managedObjectContext) private var viewContext
@State private var draggedCategory: Category?

ForEach(categories) { category in
    Text(category.name)
        .onDrag {
            draggedCategory = category
            return NSItemProvider(object: category.name as NSString)
        }
        .onDrop(of: [.text], delegate: MyDropDelegate(
            item: category,
            draggedItem: $draggedCategory,
            context: viewContext
        ))
}

补充说明 #

这种方式完全符合Core Data的设计规范：通过修改实体属性并持久化来更新数据，@Query会自动监听orderIndex的变化，重新查询并刷新UI，同时保证排序状态被持久化，重启App后排序不会丢失。

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