UICollectionView列表布局下如何仅隐藏分组首个单元格的分隔线

要实现显示所有单元格分隔线，但隐藏每个分组首个单元格分隔线的需求，不用全局关闭所有分隔线，而是通过UICollectionViewListConfiguration的separatorHandler来精细化控制每个单元格的分隔线状态，具体修改如下：

修改UICollectionView配置 #

将全局的showsSeparators设为false，然后通过separatorHandler自定义每个单元格的分隔线配置：

let collectionView: UICollectionView = {
    let provider = { (_: Int, layoutEnv: NSCollectionLayoutEnvironment) -> NSCollectionLayoutSection? in
        var configuration = UICollectionLayoutListConfiguration(appearance: .grouped)
        // 关闭全局默认分隔线，改用自定义逻辑控制
        configuration.showsSeparators = false
        configuration.footerMode = .supplementary
        
        // 设置分隔线处理闭包，逐个控制单元格分隔线
        configuration.separatorHandler = { indexPath, sectionConfig in
            var separatorConfig = sectionConfig.defaultSeparatorConfiguration
            // 判断当前单元格是否是分组内的第一个
            if indexPath.item == 0 {
                // 隐藏首个单元格的分隔线
                separatorConfig.hidden = true
            } else {
                // 其他单元格正常显示分隔线
                separatorConfig.hidden = false
                // 可按需调整分隔线样式（颜色、内边距等）
                // separatorConfig.color = .lightGray
                // separatorConfig.leftInset = UIEdgeInsets(top: 0, left: 16, bottom: 0, right: 0)
            }
            return separatorConfig
        }
        
        return .list(using: configuration, layoutEnvironment: layoutEnv)
    }
    let listLayout = UICollectionViewCompositionalLayout(sectionProvider: provider)
    return UICollectionView(frame: .zero, collectionViewLayout: listLayout)
}()

原理说明 #

• 关闭全局showsSeparators后，系统不会自动添加默认分隔线，转而使用separatorHandler返回的配置生成分隔线。
• 通过indexPath.item == 0判断当前单元格是否是所在分组的第一个，针对性隐藏其分隔线，其余单元格保持正常显示。

这种方式完全贴合UICollectionView列表布局的设计逻辑，比手动修改单元格样式更可靠。

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