SwiftUI中NavigationLink传递数组对象编辑异常问题排查

使用NavigationView搭配List，通过ForEach循环展示存储在数组中的对象列表，为每个对象绑定NavigationLink。进入子视图编辑对象部分属性时，要么输入内容无法生效，要么会自动退回至NavigationView。子视图以绑定形式接收对象，TextField也通过绑定编辑属性。

可复现代码 #

对象结构体

struct Person: Hashable {
    var name: String
    var number: String
}

导航视图

struct ContentView: View {
    
    @State var people: [Person] = testPeople // 包含若干Person实例
    
    var body: some View {
        VStack {
            NavigationView {
                List {
                    ForEach($people, id: \.self) { $person in
                        NavigationLink(destination: PersonView(person: $person)) {
                            Text(person.name)
                        }
                    }
                }
            }
        }
    }
}

导航链接子视图

struct PersonView: View {
    
    @Binding var person: Person
    
    var body: some View {
        VStack {
            Text(person.name)
            TextField("number", text: $person.number) // 用于编辑number属性的文本框
        }
    }
}

核心问题 #

你在ForEach中使用了id: \.self作为列表项的标识，而Person遵循Hashable协议，其哈希值由所有属性（name和number）共同决定。当你在子视图中修改person.number时，对象的哈希值发生变化，导致ForEach认为这是一个新的列表项，进而重新渲染列表，重置了NavigationLink的激活状态，最终出现退回列表或输入不生效的问题。

解决方案 #

给Person添加一个唯一且不可变的标识属性，让ForEach基于这个固定标识追踪列表项，而非依赖整个对象的哈希值。最简单的方式是让Person遵循Identifiable协议：

修改后的对象结构体 #

struct Person: Hashable, Identifiable {
    let id = UUID() // 生成唯一且不变的ID
    var name: String
    var number: String
}

修改后的导航视图 #

struct ContentView: View {
    
    @State var people: [Person] = testPeople
    
    var body: some View {
        VStack {
            NavigationView {
                List {
                    // 因Person实现了Identifiable，可省略id参数
                    ForEach($people) { $person in
                        NavigationLink(destination: PersonView(person: $person)) {
                            Text(person.name)
                        }
                    }
                }
            }
        }
    }
}

补充说明 #

• Identifiable协议要求类型拥有一个id属性，ForEach会自动用这个属性识别列表项，避免对象内容变化导致的列表重新渲染。
• 若不想使用UUID，也可以用业务场景中稳定的唯一值（如服务器返回的ID），只要保证该值不会随对象属性修改而变化即可。

内容的提问来源于stack exchange，提问作者Daniel Ardel-Smith