SwiftUI中@ObservableObject引发未关联子视图重复初始化问题

现象原因 #

1. @State与@ObservableObject的追踪机制差异

   • @State是值类型绑定，SwiftUI会对单个属性做精准依赖追踪，只有关联该属性的视图会触发更新，不会影响其他子视图。
   • @ObservableObject是引用类型，只要对象发出objectWillChange信号（无论哪个属性修改），所有依赖该ViewModel的父视图会重新计算body，导致父视图内所有子视图（包括未关联修改属性的）都被重新初始化。

2. Equatable协议无效的原因
   Equatable的作用是跳过视图渲染：当视图依赖的数据未变化时，SwiftUI会对比新旧视图实例的Equatable实现，若相等则不执行后续渲染流程。但它管不了视图的初始化——父视图body重建时，必然会创建新的子视图结构体实例，所以init还是会执行。

性能影响 #

• 多数场景下无需担心：SwiftUI的视图是轻量结构体，初始化本身开销极低，真正的性能瓶颈在UI渲染、数据处理等环节。
• 但如果子视图init中包含重操作（比如网络请求、大量计算、文件读写），重复初始化会直接导致性能下降，甚至界面卡顿。

解决方案 #

1. 拆分ViewModel为独立的ObservableObject #

将不同标签的属性拆分到多个ViewModel中，让每个子视图只依赖对应的ViewModel，这样单个ViewModel的变化只会触发关联子视图的更新：

class Counter1VM: ObservableObject {
    @Published var count = 0
}

class Counter2VM: ObservableObject {
    @Published var count = 0
}

struct ContentView: View {
    @StateObject var vm1 = Counter1VM()
    @StateObject var vm2 = Counter2VM()
    
    var body: some View {
        VStack {
            CustomText(count: vm1.count)
            Button("Add 1") { vm1.count += 1 }
            
            CustomText(count: vm2.count)
            Button("Add 2") { vm2.count += 1 }
        }
    }
}

2. 升级到@Observable宏（iOS 17+/macOS 14+） #

苹果推出的@Observable宏会自动为每个属性生成独立的变化追踪，替代@ObservableObject。此时修改单个属性只会触发依赖该属性的视图更新，不会导致所有子视图初始化：

@Observable
class ViewModel {
    var count1 = 0
    var count2 = 0
}

struct ContentView: View {
    @State var vm = ViewModel()
    
    var body: some View {
        VStack {
            CustomText(count: vm.count1)
            Button("Add 1") { vm.count1 += 1 }
            
            CustomText(count: vm.count2)
            Button("Add 2") { vm.count2 += 1 }
        }
    }
}

3. 将自定义操作移至生命周期回调 #

如果必须保留子视图的自定义初始化逻辑，但不想重复执行，把操作移到onAppear（仅视图首次出现时执行）或task（视图出现时启动，消失时自动取消）中：

struct CustomText: View {
    let count: Int
    @State private var hasSetup = false
    
    var body: some View {
        Text("Count: \(count)")
            .onAppear {
                guard !hasSetup else { return }
                hasSetup = true
                // 这里放只需要执行一次的自定义操作
                print("CustomText completed one-time setup")
            }
    }
}

4. 用EquatableView优化渲染（避免重复渲染，而非初始化） #

虽然无法阻止子视图初始化，但可以让子视图遵循Equatable，并使用EquatableView或.equatable()修饰符，确保当子视图依赖的数据未变化时，跳过后续渲染流程：

struct CustomText: View, Equatable {
    let count: Int
    
    static func == (lhs: CustomText, rhs: CustomText) -> Bool {
        lhs.count == rhs.count
    }
    
    init(count: Int) {
        self.count = count
        print("CustomText init") // 仍会执行，但渲染会被跳过
    }
    
    var body: some View {
        Text("Count: \(count)")
    }
}

// 在父视图中使用
EquatableView(content: CustomText(count: vm.count1))
// 或
CustomText(count: vm.count1).equatable()

内容的提问来源于stack exchange，提问作者Pablo Sanchez Gomez