UICollectionViewCell位置变更时如何正确更新数据源数组？

首先得明确一个核心点：moveItem(at:to:)这个方法只是告诉UICollectionView更新界面上cell的位置，并不会自动帮你修改数据源数组——这也是很多人踩坑的地方。你必须手动同步修改你的字符串数组，让它的顺序和UI完全匹配，不然下次刷新collectionView的时候，数据就会错乱。

我给你分几种常见场景讲具体的正确操作：

场景1：单section的普通数据源（一维数组） #

假设你的数据源是这样的：

var dataArray: [String] = ["苹果", "香蕉", "橙子", "葡萄"]

如果是通过UICollectionViewDelegate的collectionView(_:moveItemAt:to:)方法处理重排（开启了reordering功能），那直接在这个方法里同步修改数组：

func collectionView(_ collectionView: UICollectionView, moveItemAt sourceIndexPath: IndexPath, to destinationIndexPath: IndexPath) {
    // 1. 先移除原位置的元素
    let movedItem = dataArray.remove(at: sourceIndexPath.item)
    // 2. 再把元素插入到目标位置
    dataArray.insert(movedItem, at: destinationIndexPath.item)
    // 这里不需要额外调用reloadData，moveItemAt已经处理了UI动画
}

注意顺序不能搞反：如果先插入再移除，会因为数组长度变化导致索引偏移，直接出现数据错误。

场景2：多section的数据源（二维数组） #

如果你的collectionView是多section的，数据源是二维数组比如：

var sectionData: [[String]] = [
    ["苹果", "香蕉"],
    ["橙子", "葡萄"]
]

那处理跨section的移动时，要分别操作对应的section数组：

func collectionView(_ collectionView: UICollectionView, moveItemAt sourceIndexPath: IndexPath, to destinationIndexPath: IndexPath) {
    if sourceIndexPath.section == destinationIndexPath.section {
        // 同section内移动，操作同一个子数组
        let movedItem = sectionData[sourceIndexPath.section].remove(at: sourceIndexPath.item)
        sectionData[sourceIndexPath.section].insert(movedItem, at: destinationIndexPath.item)
    } else {
        // 跨section移动，从原section移除，插入到目标section
        let movedItem = sectionData[sourceIndexPath.section].remove(at: sourceIndexPath.item)
        sectionData[destinationIndexPath.section].insert(movedItem, at: destinationIndexPath.item)
    }
}

场景3：使用UICollectionViewDiffableDataSource的情况 #

如果你的项目用了Diffable Data Source（现在苹果推荐的方式），那不需要手动调用moveItem(at:to:)，直接通过更新snapshot来同步数据和UI：

// 假设你的item的Identifier是String类型
func collectionView(_ collectionView: UICollectionView, moveItemAt sourceIndexPath: IndexPath, to destinationIndexPath: IndexPath) {
    guard let movedItem = dataSource.itemIdentifier(for: sourceIndexPath) else { return }
    var snapshot = dataSource.snapshot()
    // 用snapshot的move方法更新顺序
    snapshot.moveItem(withIdentifier: movedItem, to: destinationIndexPath)
    // 应用snapshot，自动处理UI动画和数据源同步
    dataSource.apply(snapshot, animatingDifferences: true)
}

常见问题排查 #

你说数组更新异常，大概率是这几个原因：

• 数组操作顺序搞反了（先插后删导致索引错误）
• 跨section移动时没处理二维数组的对应section
• 在拖拽流程的其他方法里（比如拖拽开始、结束的代理）误操作了数组，导致数据源和UI不同步
• 用了Diffable Data Source却还手动修改原数组+调用moveItemAt，导致snapshot和数据源不一致

最后再强调一遍：数据源的顺序必须和collectionView的cell顺序完全一致，每次UI移动后，第一时间同步修改数组，就能避免大部分异常问题。

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