UICollectionView已注册Xib自定义Cell但无法显示如何解决

核心问题原因 #

你当前注册单元格的API使用错误：
register(_ cellClass: AnyClass?, forCellWithReuseIdentifier:) 仅适用于纯代码实现的UICollectionViewCell，调用这个方法注册时系统不会加载同名xib文件，只会初始化纯代码类的实例，你在xib里拖的所有控件都不会被加载，自然看不到内容。

第一步：替换注册代码 #

把viewDidLoad里的三个单元格注册逻辑全部替换为nib注册方式：

// 移除原有错误注册写法
// collectionView.register(FeaturedPlaylistCollectionViewCell.self, forCellWithReuseIdentifier: Constants.Cells.FEATURED_PLAYLIST)
// collectionView.register(NewReleasesCollectionViewCell.self, forCellWithReuseIdentifier: Constants.Cells.NEW_RELEASES)
// collectionView.register(RecommendedTrackCollectionViewCell.self, forCellWithReuseIdentifier: Constants.Cells.RECOMMENDATION)

// 替换为正确的xib注册写法
collectionView.register(
    UINib(nibName: "FeaturedPlaylistCollectionViewCell", bundle: nil),
    forCellWithReuseIdentifier: Constants.Cells.FEATURED_PLAYLIST
)
collectionView.register(
    UINib(nibName: "NewReleasesCollectionViewCell", bundle: nil),
    forCellWithReuseIdentifier: Constants.Cells.NEW_RELEASES
)
collectionView.register(
    UINib(nibName: "RecommendedTrackCollectionViewCell", bundle: nil),
    forCellWithReuseIdentifier: Constants.Cells.RECOMMENDATION
)

注意：nibName传入的字符串必须和xib文件名完全一致，大小写敏感，否则会出现加载失败或者崩溃问题。

第二步：排查其他常见配置错误 #

如果替换注册代码后单元格仍不显示，按以下优先级逐一排查：

• 补全collectionView布局约束
  你初始化collectionView时传入的frame是.zero，纯代码添加到view上的子视图如果不设置约束，默认frame为0，所有内容都不会显示。在view.addSubview(collectionView)之后添加以下约束代码：

  collectionView.translatesAutoresizingMaskIntoConstraints = false
  NSLayoutConstraint.activate([
      collectionView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
      collectionView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
      collectionView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
      collectionView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
  ])
  

• 验证Compositional Layout合法性
  检查HomeViewController.createSectionLayout方法的实现，确认每个section返回的NSCollectionLayoutSection配置了合法的item、group尺寸，不要出现宽高为0的布局配置。
• 确认数据源方法返回值正确
  实现numberOfSections(in:)和collectionView(_:numberOfItemsInSection:)两个数据源方法，确认返回的分区数、每个分区的单元格数量不为0。
• 校验xib配置正确性
  • 确认xib中File's Owner不要绑定自定义单元格类，自定义类要设置在xib的根单元格视图上
  • 所有添加的UILabel、UIImageView控件必须放在单元格的contentView上，不要直接添加到cell根视图
  • 给xib内部控件设置正确的约束，避免控件因为无约束尺寸为0无法显示
• 确认代理、数据源生命周期正常
  保证设置collectionView.dataSource = self、collectionView.delegate = self时，当前HomeViewController实例没有被提前释放，否则不会触发cellForItemAt代理方法。

快速调试方法 #

在cellForItemAt方法内加断点，根据断点触发情况定位问题：

• 断点不触发：优先排查collectionView约束、布局配置、数据源返回值、代理绑定是否正常
• 断点触发但dequeue返回nil：检查xib注册逻辑、复用标识符和xib中设置的identifier是否完全一致
• 断点触发且cell正常返回：给cell.contentView设置一个醒目的随机背景色，如果色块能显示，说明是xib内部控件约束错误，控件被压缩到尺寸为0不可见。

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