SwiftUI中ForEach遍历数组出现index out of range问题排查

错误核心原因 #

你遇到的index out of range本质是基于Range的ForEach无法正确处理数组的动态变化，具体有两个关键诱因：

1. 索引作为ID导致的视图复用错误 #

当你用ForEach(0..<lessons.count)时，SwiftUI默认把索引值当作视图的唯一ID。如果lessons数组在视图渲染过程中发生变化（比如元素被删除、异步加载后长度变更），SwiftUI的差异算法会因为ID是索引，错误地复用旧视图。
举个例子：假设数组原本有3个元素，渲染完成后数组被更新为2个元素，但SwiftUI还会尝试保留第三个视图（对应索引2），此时访问lessons[2]自然会越界。

2. 视图计算与数组状态的异步不同步 #

SwiftUI的body是惰性计算的，且视图更新是异步调度的。如果lessons是一个动态变化的数组（比如从网络异步加载数据），可能出现：

• 第一次计算0..<lessons.count时数组长度是3
• 但实际访问lessons[index]时，数组已经被更新为2个元素
  这种时间差会直接导致索引越界。

为什么正确写法能解决问题 #

ForEach(Array(lessons.enumerated()), id: \.element.id)的核心优势：

• 用元素自身的唯一ID作为视图标识，而非索引，SwiftUI能精准识别元素的增删改，不会错误复用视图
• 直接绑定到数组元素，避免了手动通过索引访问数组的风险，即使数组动态变化，也能保证访问的元素始终存在

额外建议 #

• 如果lessons不需要动态修改，尽量声明为let lessons: [Lesson]，减少意外变更的可能
• 若必须用索引遍历，也可以给Range加上明确的ID，比如ForEach(0..<lessons.count, id: \.self)，但这依然无法解决数组动态变化时的视图复用问题，仅适用于数组完全静态的场景

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