macOS Big Sur下SwiftUI列表折叠分组时子项出现重复渲染的问题
macOS 11.0.1 下 SwiftUI 嵌套折叠列表渲染异常临时方案
该问题是SwiftUI 1.0版本中List组件带嵌套children初始化逻辑的已知渲染bug,核心诱因是折叠状态变化时,List内部的视图复用索引映射发生错位,会将上层列表末尾元素重复渲染到当前同级无嵌套子节点的位置,不属于业务代码逻辑错误。
问题触发的共性代码特征
复现该问题的代码通常存在三个共性:
- 列表数据源是视图结构体中的静态
let常量,每次body求值时都会重新生成全新的元素数组实例,破坏List内部缓存的元素和视图的绑定关系 - 外层多余的无尺寸约束的VStack包裹,会导致List在macOS 11下的布局计算和复用索引偏移
- 列表结构中存在“有子节点的折叠项紧邻无子节点的同级项”的相邻组合,刚好命中原生
List(_:id:children:)初始化器在Big Sur早期版本中的状态计算逻辑漏洞
可落地的临时解决方案
- 用状态包装持有稳定的数据源实例
将视图内的静态数据迁移到@State属性中,避免每次视图渲染时重新生成数据源数组,同时移除多余的VStack包裹,给List明确的布局上下文:struct ContentView: View { @State private var data: [Item] = Item.getSampleData() var body: some View { NavigationView { List(data, id: \.id, children: \.children) { item in Text(item.name) } } } } - 给行视图绑定稳定的唯一标识,抵消复用错位
在每个列表行上手动绑定和元素UUID关联的id修饰,强制行视图和数据元素一一对应,不依赖List自动推导的行索引做视图复用:List(data, id: \.id, children: \.children) { item in Text(item.name) .id(item.id) } - 绕开原生嵌套List接口,改用递归行组件实现层级列表
完全不使用带children参数的List初始化器,手动实现递归的可折叠行结构,从根源上避开有bug的原生嵌套逻辑:// 递归行组件实现 struct RecursiveRow: View { let item: Item @State private var isExpanded: Bool = false var body: some View { Group { if let children = item.children, !children.isEmpty { DisclosureGroup(isExpanded: $isExpanded) { ForEach(children) { child in RecursiveRow(item: child) .padding(.leading, 16) } } label: { Text(item.name) } } else { Text(item.name) } } } } // 普通List中直接使用递归行组件即可 struct ContentView: View { @State private var data: [Item] = Item.getSampleData() var body: some View { NavigationView { List(data, id: \.id) { item in RecursiveRow(item: item) } } } }
兼容注意事项
- 所有列表元素的
id属性必须在应用生命周期内保持稳定,不要在视图渲染阶段动态生成新的UUID赋值给元素,否则会再次触发布局映射错乱 - macOS 11.2及以上系统版本中,官方已修复该原生List的渲染问题,上述临时方案可在低版本系统上稳定规避异常
内容的提问来源于stack exchange,提问作者Ruzard
相关产品推荐
相关产品推荐

