SwiftUI中List动态内容不更新 新增数据后列表仍显示旧数据

核心排查方向&修复方案 #

• 问题1：数据源没有实现响应式通知
  这是90%同类问题的根因：如果用普通结构体存数据数组，或者用类存数据但没有遵守ObservableObject协议、数组属性没加@Published修饰，SwiftUI无法感知数据变化，自然不会触发列表重绘。
  修复逻辑：
  1. 单条数据模型遵守Identifiable协议，给每一条数据分配全局唯一的id，不要用固定值当id
  2. 全局/共享数据源用类实现，遵守ObservableObject协议，存储列表数据的数组必须用@Published修饰
  3. 新增数据时，不要只往本地文件写数据而不更新内存中被@Published修饰的数组，写完文件要么直接给数组追加新项，要么重新读取全量文件数据赋值给数组
     参考实现：

// 单条数据模型
struct RecordItem: Identifiable {
    let id = UUID() // 每个新项生成唯一标识，不要写死固定值
    let title: String
    let createTime: Date
}

// 数据源管理类
class RecordStore: ObservableObject {
    // 被@Published修饰的数组变更时会自动通知SwiftUI刷新UI
    @Published var records: [RecordItem] = []
    
    // 从本地文件读取数据
    func loadFromLocalFile() {
        // 在这里实现原本的文件读取、解析逻辑
        // 解析完成后直接给records赋值即可触发刷新
        // 注意：如果读取逻辑在后台线程，赋值必须切回主线程
    }
    
    // 新增数据逻辑
    func addRecord(title: String) {
        let newItem = RecordItem(title: title, createTime: Date())
        // 1. 先执行原本的写入本地文件逻辑
        // 2. 写入成功后更新内存中的数据源，二选一即可
        records.append(newItem) // 方式1：直接追加新项
        // loadFromLocalFile() // 方式2：重新全量读取文件
    }
}

• 问题2：视图层状态修饰符用错，绑定断裂
  常见错误场景：
  1. 用@State修饰遵守ObservableObject的数据源实例，正确做法是当前视图创建的数据源用@StateObject（iOS14+），父视图传过来的数据源用@ObservedObject
  2. 列表项里把父视图传过来的数据重新赋值给本地@State变量，导致和原数据源断了绑定
  3. 跨页面传数据源时没有用@EnvironmentObject注入，而是新创建了一个数据源实例，导致修改的是A实例，列表监听的是B实例，永远看不到更新
     正确的视图层写法参考：

struct RecordListView: View {
    // 当前视图持有的数据源用@StateObject修饰，不要用@State
    @StateObject private var store = RecordStore()
    
    var body: some View {
        List(store.records) { record in
            RecordRow(item: record)
        }
        .onAppear {
            store.loadFromLocalFile()
        }
    }
}

// 列表项
struct RecordRow: View {
    let item: RecordItem // 直接用父视图传值，不要重新定义本地@State拷贝
    var body: some View {
        VStack(alignment: .leading) {
            Text(item.title)
            Text(item.createTime.formatted())
                .font(.caption)
                .foregroundColor(.gray)
        }
    }
}

• 问题3：本地文件变更没有触发重新读取
  如果数据不是通过App内的操作新增，是被外部逻辑/其他进程修改，不要只在onAppear时读一次文件。可以给本地文件加源事件监听，收到文件变更通知时主动调用loadFromLocalFile()重新拉取数据即可。
• 问题4：线程或标识配置错误
  1. 所有更新@Published属性的操作必须在主线程执行，后台线程读完文件要手动切回主线程再赋值
  2. 如果List用了id:\.self做标识符，要确保新增项和已有项不会被判定为相等，否则List会认为是同一条数据不触发刷新，优先给模型实现Identifiable用唯一id做标识。

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