You need to enable JavaScript to run this app. macOS Big Sur下SwiftUI列表折叠分组时子项出现重复渲染的问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 17:24:04