SwiftUI中模型变更后视图未自动更新的问题排查

核心问题 #

Deck视图无法自动刷新的原因是未正确订阅Deck对象的属性变化：SwiftData的@Model类本身是可观察类型，但直接将Deck作为普通变量传入DeckView时，视图无法感知其关联的cards数组更新。

具体修复步骤 #

1. 让DeckView订阅Deck对象的变化 #

在DeckView中用@Bindable修饰传入的Deck实例，让视图能感知到其属性（包括cards）的变化：

struct DeckView: View {
    @Bindable var deck: Deck  // 添加@Bindable，订阅Deck的变化
    
    var body: some View {
        List {
            // 安全解包可选的cards数组，遍历展示卡片
            ForEach(deck.cards ?? []) { card in
                VStack {
                    Text(card.front)
                }
            }
        }
    }
}

2. 修正DecksView的NavigationStack结构 #

原代码将NavigationStack嵌套在List内部，会导致导航状态与视图更新的联动异常，需将NavigationStack作为外层容器：

struct DecksView: View {
    @Query() var decks: [Deck]
    @Environment(RouterModel.self) var routerModel  // 补充路由模型的环境注入
    
    var body: some View {
        NavigationStack(path: $routerModel.path) {
            List {
                ForEach(decks, id: \.self) { deck in
                    NavigationLink(value: Path.deck(deck)) {
                        Text(deck.name)
                    }
                }
            }
            .navigationDestination(for: Path.self) { path in
                switch path {
                    case .decks:
                        DecksView()
                    case let .deck(deck):
                        DeckView(deck: deck)
                    case let .card(card):
                        CardView(card: card)
                }
            }
        }
    }
}

3. 确保上下文变化及时同步（可选） #

插入卡片后手动保存上下文，避免因自动保存延迟导致的视图更新不及时：

private func addCard() {
    guard let deck = cardModel.deck else { return }
    let newCard = Card(front: front, deck: deck)
            
    withAnimation {
        modelContext.insert(newCard)
        // 手动保存上下文
        do {
            try modelContext.save()
        } catch {
            print("保存卡片失败：\(error.localizedDescription)")
        }
    }
}

补充说明 #

• SwiftData的@Model类是引用类型，你通过CardModel传递Deck的方式没问题，不存在值传递的问题。
• 删除卡片时的刷新问题也会因上述修复解决，因为@Bindable会感知到deck.cards数组的移除操作。

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