如何让UICollectionView（组合布局）中UILabel单元格强制换行？

问题原因 #

当单个标签文本过长时，NSCollectionLayoutItem的估算宽度会超过水平组的可用宽度（集合视图宽度减去section内边距），导致组无法容纳该item，触发崩溃。当前布局未限制item的最大宽度，同时组的高度未适配标签换行后的高度变化。

解决方案 #

1. 限制Item的最大宽度
   使用constrainedDimension将item的估算宽度限制在组的可用宽度内，确保文本过长时item宽度不会超出组范围，给Label留出换行空间：

   // 限制item宽度为估算值，但最大占满组宽度
   let itemWidth = NSCollectionLayoutDimension.constrainedDimension(
       dimension: .estimated(50),
       maximumDimension: .fractionalWidth(1)
   )
   let layoutSize = NSCollectionLayoutSize(
       widthDimension: itemWidth,
       heightDimension: .estimated(20)
   )
   let item = NSCollectionLayoutItem(layoutSize: layoutSize)
   

2. 调整组的高度为自适应
   将组的高度设为估算值，适配标签换行后的高度变化：

   let group = NSCollectionLayoutGroup.horizontal(
       layoutSize: NSCollectionLayoutSize(
           widthDimension: .fractionalWidth(1),
           heightDimension: .estimated(20) // 适配换行后的标签高度
       ),
       subitems: [item]
   )
   group.interItemSpacing = .fixed(10)
   

3. 确认Cell的布局与Label设置

   • 确保UILabel的numberOfLines设为0，lineBreakMode设为.byWordWrapping（或.byCharWrapping，按需选择）；
   • Label的top、leading、bottom、trailing约束完全贴紧cell的contentView；
   • 确认xib的自动布局约束无冲突。

完整修改后的布局代码 #

// 定义item尺寸：估算宽度，最大占满组宽度
let itemWidth = NSCollectionLayoutDimension.constrainedDimension(
    dimension: .estimated(50),
    maximumDimension: .fractionalWidth(1)
)
let layoutSize = NSCollectionLayoutSize(
    widthDimension: itemWidth,
    heightDimension: .estimated(20)
)
let item = NSCollectionLayoutItem(layoutSize: layoutSize)

// 定义水平组：宽度占满集合视图，高度自适应
let group = NSCollectionLayoutGroup.horizontal(
    layoutSize: NSCollectionLayoutSize(
        widthDimension: .fractionalWidth(1),
        heightDimension: .estimated(20)
    ),
    subitems: [item]
)
group.interItemSpacing = .fixed(10)

// 定义section
let section = NSCollectionLayoutSection(group: group)
section.contentInsets = .init(top: 4, leading: 16, bottom: 4, trailing: 16)

// 创建布局
let layout = UICollectionViewCompositionalLayout(section: section)
let collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)

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