NavigationSplitView与@State变量的异常行为问题排查

问题原因 #

@State是SwiftUI用于管理视图内部状态的属性包装器，它的生命周期由SwiftUI独立维护，仅在视图首次实例化时执行初始化赋值。当NavigationSplitView切换侧边栏条目时，详情视图的输入参数（如name）会更新，但SwiftUI会保留@State变量的原有值，不会因为视图刷新或init调用而重新赋值——即使你在init里给@State赋值，后续也会被SwiftUI的状态管理逻辑覆盖。

解决方案 #

方案1：直接使用输入参数（无需内部状态） #

如果不需要修改该变量，直接使用传入的参数渲染即可，完全不需要@State：

struct DetailView: View {
    let name: String
    
    var body: some View {
        Text(name)
    }
}

方案2：用.onChange同步参数到@State #

如果需要将参数作为初始值，后续要修改这个内部状态，通过.onChange监听参数变化，主动更新@State：

struct DetailView: View {
    let name: String
    @State private var displayName: String
    
    init(name: String) {
        self.name = name
        // 下划线访问@State的底层存储，完成初始赋值
        _displayName = State(initialValue: name)
    }
    
    var body: some View {
        Text(displayName)
            // 监听name参数变化，同步更新内部状态
            .onChange(of: name) { newName in
                displayName = newName
            }
    }
}

方案3：用ViewModel管理状态（适合复杂逻辑） #

如果涉及更复杂的状态逻辑，使用@StateObject结合ViewModel来管理，通过参数变化触发ViewModel更新：

class DetailViewModel: ObservableObject {
    @Published var displayName: String
    
    init(name: String) {
        self.displayName = name
    }
    
    func updateName(_ newName: String) {
        displayName = newName
    }
}

struct DetailView: View {
    let name: String
    @StateObject private var viewModel: DetailViewModel
    
    init(name: String) {
        self.name = name
        _viewModel = StateObject(wrappedValue: DetailViewModel(name: name))
    }
    
    var body: some View {
        Text(viewModel.displayName)
            .onChange(of: name) { newName in
                viewModel.updateName(newName)
            }
    }
}

关键说明 #

不要依赖视图的init方法更新@State变量——SwiftUI会优先保留@State的现有状态，忽略init中的重复赋值。所有对@State的更新操作，都要通过SwiftUI的响应式API（如.onChange、绑定、Published等）来触发，确保状态同步。

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