SwiftUI中background修饰器重用视图实例问题咨询

问题描述 #

在SwiftUI中使用ForEach加载带有background视图修饰器的视图时，当模型变化触发ForEach重新加载，视图本身会更新，但background修饰器中创建的实例却被复用，导致视图使用错误的数据。

场景复现 #

给定如下视图结构：

struct PathView: some View {
  let path: URL

  init(path: URL) { // <-- 调试显示此处会被调用8次
    self.path = path
  }

  var body: some View {
    VStack {
      ...
    }
    .background(SubDirView(of: path)) // <-- 此处未创建新的SubDirView实例
  }
}

通过ForEach加载8个PathView实例：

ForEach(0...7, id: \.self) { index in
  PathView(path: paths[index])
}

当paths数组发生变化时，PathView的构造器被调用8次（符合预期），但SubDirView并未创建新实例，而是复用旧实例，导致其使用错误的path。

原因解释 #

这是SwiftUI的预期行为，与Swift语言特性无关，核心源于SwiftUI的视图身份识别与复用机制：

• 视图身份的判断逻辑：SwiftUI不会根据视图结构体的创建来决定是否重建UI，而是通过视图身份（由id或视图类型+数据依赖组合判定）追踪视图生命周期。当ForEach使用\.self（即索引值）作为id时，0-7的索引未发生变化，SwiftUI会认为这些位置的PathView是同一身份的视图，仅会更新其path属性，而非完全销毁重建。
• 修饰器的实例复用：background修饰器返回的BackgroundModifier由SwiftUI视图树管理。当父视图（PathView）被判定为“更新而非重建”时，SwiftUI会尝试复用已存在的修饰器实例，包括其内部的SubDirView。若SubDirView未将path作为关键依赖项，就会出现数据不更新的情况。
• 值类型结构体的误导性：SwiftUI视图是值类型结构体，每次调用PathView(path: ...)只是生成新的结构体值，但这仅作为视图的“描述蓝图”，不等于SwiftUI会创建对应的实际UI对象。实际UI元素的创建或复用由视图身份决定。

解决方案 #

• 使用精准的视图身份标识：将ForEach的id从索引改为path的唯一标识，比如：

  ForEach(paths, id: \.absoluteString) { path in
    PathView(path: path)
  }
  

  这样当path变化时，SwiftUI会识别到视图身份已改变，从而重建整个视图链，包括background中的SubDirView。
• 为PathView添加显式id：给PathView绑定与path关联的id修饰器，强制SwiftUI在path变化时重建视图：

  PathView(path: paths[index])
    .id(paths[index].absoluteString)
  

• 检查SubDirView的实现：确保SubDirView直接使用传入的let path: URL属性，避免用@State缓存旧数据，保证path变化时body能重新计算并更新内容。

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