SwiftData中如何实现列表手动重排功能？

核心思路 #

@Query 返回的数组是只读的，无法直接调用 move 方法修改顺序。我们需要通过更新模型的排序字段来实现手动排序：利用 @Query 依赖的 order 属性作为排序依据，手动调整顺序后重新为每个元素分配 order 值，再保存到 SwiftData 中，触发列表自动刷新。

实现步骤 #

1. 确保模型包含排序字段

确认你的 FavouriteCommunity 模型已定义 order 属性（用于控制排序）：

@Model
class FavouriteCommunity {
    var name: String
    var order: Int // 排序核心字段
    
    init(name: String, order: Int) {
        self.name = name
        self.order = order
    }
}

2. 修改视图代码实现手动排序

通过复制可变数组、调整顺序后更新 order 值，再保存上下文：

import SwiftUI
import SwiftData

struct CommunityListView: View {
    @Environment(\.modelContext) private var modelContext
    @Query(sort: \FavouriteCommunity.order) private var favouriteCommunities: [FavouriteCommunity]
    
    var body: some View {
        List {
            Section("Top communities") {
                // 其他视图内容
            }
            Section("Favorites") {
                ForEach(favouriteCommunities) { item in
                    NavigationLink(value: item) {
                        FavouriteCommunityCellView(item: item)
                    }
                }
                .onMove { fromOffsets, toOffset in
                    // 1. 复制只读数组为可变副本
                    var mutableCommunities = favouriteCommunities
                    // 2. 调整副本的顺序
                    mutableCommunities.move(fromOffsets: fromOffsets, toOffset: toOffset)
                    // 3. 重新分配每个元素的order值
                    for (index, community) in mutableCommunities.enumerated() {
                        community.order = index
                    }
                    // 4. 保存修改到SwiftData，触发列表刷新
                    do {
                        try modelContext.save()
                    } catch {
                        print("排序保存失败：\(error.localizedDescription)")
                    }
                }
            }
        }
        .toolbar {
            EditButton() // 添加编辑按钮开启排序功能
        }
    }
}

关键说明 #

• 不能直接修改 @Query 返回的数组，因为它是只读的绑定值；
• 调整顺序后更新 order 字段，是让 @Query 重新排序并刷新列表的核心逻辑；
• 保存上下文时需处理错误，避免因数据问题导致崩溃。

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