UICollectionViewCell添加UILabel/UIImageView时固定尺寸失效问题咨询

问题本质 #

当你通过sizeForItemAt返回固定单元格尺寸，却出现子视图（UILabel、UIImageView等）反向撑大/缩小单元格的问题，核心原因有两个：

1. UICollectionViewFlowLayout默认开启了Self Sizing自适应尺寸机制，会优先通过子视图的固有内容尺寸（intrinsic content size）计算单元格实际大小
2. 子视图默认的内容布局优先级高于单元格尺寸约束的优先级，系统在约束冲突时会优先满足子视图的内容显示要求，打破你预设的固定单元格尺寸

标准实现步骤 #

1. 关闭流布局的预估自适应尺寸 #

这是最核心的配置项，多数人出现布局异常都是漏了这步：

• 如果你用Storyboard配置流布局：选中UICollectionView的Flow Layout，在右侧Size Inspector面板中找到Estimate Size选项，直接设置为None
• 如果你用代码初始化布局，添加如下配置：

let flowLayout = UICollectionViewFlowLayout()
// 关闭预估尺寸，完全使用代理返回的固定尺寸
flowLayout.estimatedItemSize = .zero
// 其余布局属性（间距、滚动方向等）按需配置

2. 正确配置子视图约束与布局优先级 #

所有添加到contentView上的子视图，按以下规则配置：

• 给子视图添加完整的确定约束：比如UILabel需要固定上下左右边距到contentView，不要使用大于等于/小于等于的宽松约束关系，所有边距设为固定值
• 将子视图水平、垂直两个方向的contentHuggingPriority（内容拥抱优先级，控制视图不被拉伸到大于内容尺寸的优先级）、contentCompressionResistancePriority（内容压缩抵抗优先级，控制视图不被压缩到小于内容尺寸的优先级）都设置为低于1000（默认必填优先级），常规场景设为250（系统默认低优先级）即可，不需要拉到最低值1。
  你之前只修改contentHuggingPriority无法解决长文本撑大单元格的问题，就是因为长文本撑大单元格触发的是压缩抵抗优先级逻辑，只有降低这个优先级，系统才会在约束冲突时优先压缩子视图尺寸，保证单元格大小不变。

3. 子视图适配配置 #

• UILabel字体自适应：约束配置完成后，勾选UILabel的Adjust to Fit选项，设置minimumScaleFactor（最小字体缩放比例，一般设为0.3~0.5即可），按需求设置numberOfLines，单元格固定尺寸下长文本会自动缩小字体适配，不会溢出也不会撑大单元格。
• UIImageView图片适配：不要手动修改UIImageView的intrinsic content size，根据显示需求设置contentMode为scaleAspectFit（等比例缩放完整显示）或scaleAspectFill（等比例缩放填满视图，裁剪超出部分）即可，图片无论原始尺寸多大，都会被约束在UIImageView的固定frame内，不会反向影响单元格尺寸。

临时方案说明 #

你之前将contentCompressionResistancePriority设为1能暂时修复问题，本质是强行降低子视图的约束优先级，绕开了系统的自适应尺寸计算，但如果不关闭estimatedItemSize，后续多子视图复杂布局场景下仍可能出现约束冲突日志、偶发布局错乱问题，不属于标准实现。

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