如何为位置变化导致排序变更的TableView单元格添加动画？

我正在开发一款通过TableView向用户展示附近标注（annotation）的APP，单元格按与用户位置的距离排序。我希望在单元格因距离变化导致排序变更时添加动画，该如何实现？

我尝试过以下代码，但没有效果：

tableView.beginUpdates()
tableView.moveRow(at: IndexPath(row: fromIndex, section: 0), to: IndexPath(row: toIndex, section: 0))
tableView.endUpdates()

补充：我还尝试了如下代码，效果接近但不符合预期——单个单元格排序变更时所有单元格都会产生动画：
（didUpdateLocations 方法内代码）

sortedAnnotationArrayWithModel = annotationArrayWithModel.sorted { $0.distance < $1.distance }
tableView.reloadData()
tableView.beginUpdates()
    for i in 0..<sortedAnnotationArrayWithModel.count {
        let oldIndex = annotationArrayWithModel.firstIndex(of: sortedAnnotationArrayWithModel[i])
        let newIndex = i
        if oldIndex != newIndex {
            tableView.moveRow(at: IndexPath(row: oldIndex!, section: 0), to: IndexPath(row: newIndex, section: 0))
        }
    }
tableView.endUpdates()

核心问题在于你误用了reloadData（会全局刷新单元格，打乱动画队列），且数据源更新逻辑和动画执行顺序颠倒。以下是正确实现方式：

1. 先存旧数据源快照，再生成新排序结果
   不要直接覆盖原数据源，先保留旧数组用于对比位置变化，再基于旧数组生成排序后的新数组。

2. 精准执行单个单元格移动动画
   遍历新数组，对比每个元素在旧数组中的位置，仅对位置变化的单元格执行移动操作，全程不要调用reloadData。

3. 正确代码示例
   替换didUpdateLocations中的代码为：

   // 保存旧数据源快照
   let oldAnnotations = annotationArrayWithModel
   // 生成排序后的新数据源
   let newAnnotations = oldAnnotations.sorted { $0.distance < $1.distance }
   
   tableView.beginUpdates()
   
   // 遍历新数组，处理位置变化的单元格
   for (newIndex, annotation) in newAnnotations.enumerated() {
       guard let oldIndex = oldAnnotations.firstIndex(of: annotation), oldIndex != newIndex else {
           continue
       }
       tableView.moveRow(at: IndexPath(row: oldIndex, section: 0), to: IndexPath(row: newIndex, section: 0))
   }
   
   tableView.endUpdates()
   
   // 最后更新数据源
   annotationArrayWithModel = newAnnotations
   

4. 关键注意事项

   • 确保你的标注模型实现了Equatable协议，否则firstIndex(of:)无法准确匹配元素。
   • 可以设置距离阈值（比如变化超过10米才触发更新），避免因微小距离波动导致频繁动画。
   • 绝对不要在beginUpdates()和endUpdates()之间调用reloadData()，会直接破坏动画逻辑。

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