SwiftUI NavigationSplitView切换侧边栏项后详情视图不更新求助

问题概述 #

在SwiftUI的NavigationSplitView中，首次点击侧边栏列表项能正常显示对应详情视图，但再次点击其他项时，详情视图停留在之前的内容，无法更新。无论是使用NavigationLink还是列表选择绑定的方式，都出现了这个问题，且该问题不仅限于SwiftData模型，自定义类/结构体也会触发。

核心原因 #

SwiftUI的视图更新依赖可检测的状态变化：

• 对于引用类型（如SwiftData的MyModel类），直接用@State存储实例时，SwiftUI无法感知实例的替换（因为跟踪的是引用地址，而非实例内容）
• 使用NavigationLink时，NavigationSplitView会复用之前的详情视图实例，没有根据新的模型数据重新初始化

解决方案 #

方法1：通过ID绑定选择状态（推荐） #

利用SwiftData模型自动遵循Identifiable的特性，存储选中模型的ID而非实例本身，让SwiftUI能通过ID的变化感知状态更新，从而重新渲染详情视图。

修改后的ContentView代码：

struct ContentView: View {
    @Environment(\.modelContext) var modelContext
    @Query var models: [MyModel]
    // 存储选中模型的ID，而非实例
    @State private var selectedModelId: MyModel.ID?

    var body: some View {
        NavigationSplitView {
            List(selection: $selectedModelId) {
                ForEach(models) { model in
                    Text(model.text)
                        .tag(model.id) // 绑定模型ID作为选择标签
                }
            }
        } detail: {
            // 根据ID匹配对应的模型实例
            if let selectedId = selectedModelId,
               let selectedModel = models.first(where: { $0.id == selectedId }) {
                MyModelEditView(myModel: selectedModel)
                    .modelContext(modelContext)
            } else {
                Text("Tap plus for a new model")
            }
        }
        .toolbar {
            Button("Add") {
                modelContext.insert(MyModel(text: "New Item"))
            }
        }
    }
}

同时修改MyModelEditView，使用@Bindable替代@State（SwiftData模型是Observable类型，@Bindable能自动同步编辑状态）：

struct MyModelEditView: View {
    @Environment(\.modelContext) var modelContext
    @Bindable var myModel: MyModel

    var body: some View {
        TextField("Edit Text", text: $myModel.text)
    }
}

方法2：强制刷新详情视图 #

如果坚持使用NavigationLink，可以给详情视图添加基于模型ID的.id()修饰符，强制SwiftUI在模型变化时重新创建视图实例。

修改后的ContentView代码：

struct ContentView: View {
    @Environment(\.modelContext) var modelContext
    @Query var models: [MyModel]

    var body: some View {
        NavigationSplitView {
            List {
                ForEach(models) { model in
                    NavigationLink {
                        MyModelEditView(myModel: model)
                            .modelContext(modelContext)
                            .id(model.id) // 绑定模型ID，强制视图刷新
                    } label: {
                        Text(model.text)
                    }
                }
            }
        } detail: {
            Text("Tap plus for a new model")
        }
        .toolbar {
            Button("Add") {
                modelContext.insert(MyModel(text: "New Item"))
            }
        }
    }
}

MyModelEditView同样需要改为使用@Bindable，代码同方法1中的对应部分。

关键提示 #

• 对于引用类型，优先使用ID而非实例本身作为状态跟踪对象，避免SwiftUI无法感知实例替换的问题
• @Bindable是处理SwiftData模型编辑的最佳方式，能自动同步模型的变化到视图和数据库
• .id()修饰符是强制视图刷新的通用手段，适用于需要强制重建视图的场景

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