SwiftUI中SwiftData实体增删后视图不更新的问题排查与解决

问题原因 #

核心问题在于增删实体后没有更新ViewModel中的items数组：

• 初始化时你通过fetchData()获取数据并赋值给items，但后续添加/删除实体后，没有重新获取最新数据并更新items，UI绑定的始终是旧数组，因此无法即时看到变化。
• 更新操作能生效是因为SwiftData的实体本身是可观察对象，修改实体属性时会自动通知UI刷新，但数组元素的增删不会自动触发items的更新。

解决方案 #

方案一：手动更新items数组

在增删操作完成后，重新调用fetchData()并赋值给items，利用ViewModel的@Observable特性触发UI刷新：

// 修改ContentViewModel中的insert和delete方法
func insert(_ item: Item) {
    modelContext.insert(item)
    save()
    items = fetchData() // 新增：重新获取最新数据
}

func delete(_ item: Item) {
    modelContext.delete(item)
    save()
    items = fetchData() // 新增：重新获取最新数据
}

方案二：使用SwiftData的@Query自动监听数据（更推荐）

SwiftData提供的@Query属性能自动监听数据变化并同步到UI，无需手动调用fetch，完全贴合SwiftData的设计理念：

修改ViewModel版本

@Observable
class ContentViewModel {
    var modelContext: ModelContext
    // 用@Query替代手动fetch的items，自动排序并监听变化
    @Query(sort: [SortDescriptor<Item>(\.dateAdded, order: .forward)])
    var items: [Item]
    
    var showingSheet: Bool = false
    var name: String = ""
    var content: String = ""
    var editingItem: Item?

    init(modelContext: ModelContext) {
        self.modelContext = modelContext
        // 无需手动调用fetchData，@Query自动加载数据
    }

    // 移除原fetchData方法，不再需要
    
    // 其他方法保持不变，增删改后@Query会自动更新items
}

更简洁的View直接使用@Query版本

如果不需要复杂的ViewModel逻辑，也可以直接在View中使用@Query，省去手动维护数组的麻烦：

struct ContentView: View {
    @Environment(\.modelContext) private var modelContext
    @Query(sort: [SortDescriptor<Item>(\.dateAdded, order: .forward)]) private var items: [Item]
    
    @State private var showingSheet = false
    @State private var name = ""
    @State private var content = ""
    @State private var editingItem: Item?

    var body: some View {
        NavigationStack {
            List {
                ForEach(items) { item in
                    VStack(alignment: .leading) {
                        HStack(alignment: .top) {
                            Text(item.name).bold()
                            Spacer()
                            Text(item.dateAdded.formatted(date: .numeric, time: .shortened))
                                .font(.caption)
                                .foregroundStyle(.gray)
                            Button(action: {
                                editingItem = item
                                name = item.name
                                content = item.content
                                showingSheet = true
                            }) {
                                Image(systemName: "pencil").foregroundColor(.blue)
                            }
                            Button(action: {
                                modelContext.delete(item)
                                try? modelContext.save()
                            }) {
                                Image(systemName: "trash").foregroundColor(.red)
                            }
                        }
                        Text(item.content).font(.subheadline)
                    }
                }
            }
            .navigationTitle("To Do List")
            .toolbar {
                ToolbarItem(placement: .automatic) {
                    Button {
                        editingItem = nil
                        name = ""
                        content = ""
                        showingSheet = true
                    } label: {
                        Image(systemName: "plus")
                    }
                }
            }
            .sheet(isPresented: $showingSheet) {
                Form {
                    Section("Title") {
                        TextField("Add the title...", text: $name)
                    }
                    Section("Content / Notes") {
                        TextEditor(text: $content)
                    }
                    Section {
                        if let editingItem = editingItem {
                            Button("Update Item") {
                                editingItem.name = name
                                editingItem.content = content
                                editingItem.dateAdded = Date()
                                try? modelContext.save()
                                showingSheet = false
                            }
                            .disabled(name.isEmpty || content.isEmpty)
                        } else {
                            Button("Add Item") {
                                let newItem = Item(name: name, content: content)
                                modelContext.insert(newItem)
                                try? modelContext.save()
                                showingSheet = false
                            }
                            .disabled(name.isEmpty || content.isEmpty)
                        }
                    }
                }
            }
        }
    }
}

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