使用UICollectionViewDiffableDataSource时如何处理静态header等无配置内容？

架构老林

2026-9-25

针对静态UICollectionView supplementary view的Diffable Data Source适配方案

方案1：自定义可哈希占位类型

定义一个仅包含单例case的枚举，专门作为静态元素的占位标识，天然满足Hashable协议要求：

// 全局唯一静态Header占位类型
enum StaticSectionHeader: Hashable {
    case `default`
}

所有该类型实例的哈希值完全一致，diff比对时永远不会判定为内容变更，刚好适配静态内容无需更新的特性。
使用时直接往snapshot中添加该占位值即可：

var snapshot = NSDiffableDataSourceSnapshot<YourSectionType, YourItemType>()
snapshot.appendSections([.main])
// 给目标section添加header占位
snapshot.appendSupplementaryItems(
    ofKind: UICollectionView.elementKindSectionHeader,
    with: [StaticSectionHeader.default],
    toSection: .main
)

在supplementaryViewProvider中直接返回预配置的静态Header即可，不需要对占位值做额外处理。

方案2：跳过supplementary item配置，直接通过section映射返回

如果你的Header是固定对应某类/所有section的静态内容，完全不需要往snapshot中添加supplementary item，直接在supplementary view provider回调中根据section信息返回静态Header即可：

dataSource.supplementaryViewProvider = { collectionView, kind, indexPath in
    guard kind == UICollectionView.elementKindSectionHeader else { return nil }
    let header = collectionView.dequeueReusableSupplementaryView(
        ofKind: kind,
        withReuseIdentifier: "StaticHeaderID",
        for: indexPath
    )
    // 静态内容无需额外配置，直接返回
    return header
}

这种方式不需要处理任何占位值逻辑，适配性更高。