求助：UICollectionView首个单元格显示被截断如何解决

我之前也踩过一模一样的坑——用IB拖好原型单元格，约束和高度都设置得明明白白，结果跑起来第一个cell还是被截掉一块。结合你的场景，给你几个最常见的排查和解决方向：

1. 检查CollectionView Flow Layout的配置 #

这是最容易出问题的核心点：

• 如果用固定高度：
  一定要在代码里明确设置itemSize的高度，并且和原型单元格的高度保持一致，同时关闭自动估算避免冲突：

  override func viewDidLoad() {
      super.viewDidLoad()
      // 其他导航栏相关设置...
      guard let flowLayout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout else { return }
      // 替换成你实际设置的单元格固定高度
      flowLayout.itemSize = CGSize(width: collectionView.frame.width, height: 120)
      flowLayout.estimatedItemSize = .zero
  }
  

• 如果用自动高度：
  把estimatedItemSize设为自动模式，同时必须保证原型单元格有完整的垂直约束链：

  flowLayout.estimatedItemSize = UICollectionViewFlowLayout.automaticSize
  

2. 确认原型单元格的约束完整性 #

打开IB选中你的原型单元格，检查右侧Constraints面板：

• 不能有红色警告（缺失约束或约束冲突）
• 必须构建完整的垂直约束链：从cell的顶部边缘，到内部控件的top约束，控件之间的垂直间距，最后到cell的底部边缘。比如一个带UILabel的cell，需要有：
  • Label.top = Cell.top + 8
  • Label.bottom = Cell.bottom - 8
  • Label.leading/trailing 约束到cell边缘
    只有这样AutoLayout才能正确计算单元格高度，不会出现计算偏差导致截断。

3. 调整布局设置的时机 #

viewDidLoad时collectionView的frame可能还没完全确定，导致布局计算错误。可以把布局设置移到viewDidLayoutSubviews里，并且只执行一次：

private var hasConfiguredLayout = false

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    guard !hasConfiguredLayout else { return }
    hasConfiguredLayout = true
    
    if let flowLayout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout {
        flowLayout.itemSize = CGSize(width: collectionView.bounds.width, height: 120)
        flowLayout.sectionInset = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0)
    }
}

4. 排查Content Inset的自动调整问题 #

如果你的导航栏是半透明状态，系统会自动调整collectionView的contentInset，导致第一个cell被导航栏挡住，看起来像是被截断。可以关闭这个自动调整：

collectionView.contentInsetAdjustmentBehavior = .never

或者在IB里选中CollectionView，在Attributes Inspector里把Content Inset Adjustment Behavior设为Never。

5. 检查单元格的Clips To Bounds属性 #

偶尔会遇到原型单元格的clipsToBounds被设为true，导致内容超出cell范围时被截断。可以在IB里选中单元格，把这个属性关掉，或者代码里设置：

cell.clipsToBounds = false

先从这几个方向排查，大概率能解决问题。

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