UICollectionViewController+DiffableDataSource单元格未保持高亮问题求助

我确实碰到过这个诡异的问题！这大概率是UICollectionViewController搭配DiffableDataSource时，Apple框架层面的一个小bug，但我们可以通过一些调整来规避它。

可能的触发原因 #

UICollectionViewController内部对高亮/选中状态的默认处理逻辑，和DiffableDataSource的快照更新机制存在冲突——哪怕你没有主动更新数据，DiffableDataSource后台的一些隐性快照同步操作，都可能触发collectionView的局部重绘，意外把还在按住状态的单元格高亮给取消了。

两种可行的解决思路 #

方案1：手动接管高亮状态的样式控制 #

绕过系统的默认高亮逻辑，自己控制单元格的视觉变化：

override func collectionView(_ collectionView: UICollectionView, didHighlightItemAt indexPath: IndexPath) {
    print("cell highlighted")
    guard let cell = collectionView.cellForItem(at: indexPath) else { return }
    // 自定义高亮样式，比如修改背景色
    cell.backgroundColor = .systemGray5
}

override func collectionView(_ collectionView: UICollectionView, didUnhighlightItemAt indexPath: IndexPath) {
    print("cell unhighlighted")
    guard let cell = collectionView.cellForItem(at: indexPath) else { return }
    // 恢复原样式
    cell.backgroundColor = .systemBackground
}

记得在cellForItemAt方法里初始化单元格的默认样式，避免状态混乱。

方案2：调整UICollectionViewController的状态管理配置 #

在控制器的初始化方法（比如init(collectionViewLayout:)）里添加这行代码：

self.clearsSelectionOnViewWillAppear = false

这会阻止控制器在生命周期阶段自动清除选中/高亮状态，减少和DiffableDataSource的冲突。另外也可以明确设置选择权限：

override func viewDidLoad() {
    super.viewDidLoad()
    collectionView.allowsSelection = true
    collectionView.allowsMultipleSelection = false
}

额外排查点 #

• 检查代码中是否频繁调用apply(_:animatingDifferences:)，哪怕快照内容没变化，重复调用也可能触发这个问题。可以加个判断，只有快照真的有更新时才执行apply。
• 试试换成UICollectionViewCompositionalLayout，部分开发者反馈新布局和DiffableDataSource的兼容性更好。

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