UICollectionViewController未注册自定义Cell类致单元格颜色不生效

我帮你梳理下问题所在，你自定义了HomePostCell但没看到预期的蓝色单元格，大概率是布局约束或CollectionView的布局配置没做好，下面是具体的排查和解决办法：

1. 核心问题：未配置CollectionView的Item尺寸 #

默认的UICollectionViewFlowLayout不会自动设置单元格的大小，你的单元格可能因为尺寸为0而完全不可见。在viewDidLoad里补充布局配置即可：

override func viewDidLoad() {
    super.viewDidLoad()
    collectionView?.backgroundColor = .white
    collectionView?.register(HomePostCell.self, forCellWithReuseIdentifier: cellId)
    
    // 添加流水布局的尺寸设置
    if let flowLayout = collectionView?.collectionViewLayout as? UICollectionViewFlowLayout {
        flowLayout.itemSize = CGSize(width: view.frame.width, height: 200) // 高度可以根据需求调整
        flowLayout.minimumLineSpacing = 8 // 可选：设置单元格之间的间距
    }
}

2. 检查自定义Anchor方法的约束有效性 #

你代码里用了photoImageView.anchor(...)这个封装方法，如果是自己写的扩展，要确保它正确处理了AutoLayout的关键设置：必须禁用视图的自动约束转换。修改photoImageView的初始化代码：

let photoImageView: UIImageView = {
    let iv = UIImageView()
    iv.backgroundColor = .blue
    iv.translatesAutoresizingMaskIntoConstraints = false // 这一行必不可少，否则自定义约束不生效
    return iv
}()

如果不确定自定义anchor方法的可靠性，也可以直接用系统原生的约束API替代，更稳妥：

override init(frame: CGRect) {
    super.init(frame: frame)
    addSubview(photoImageView)
    
    NSLayoutConstraint.activate([
        photoImageView.topAnchor.constraint(equalTo: topAnchor),
        photoImageView.leadingAnchor.constraint(equalTo: leadingAnchor),
        photoImageView.trailingAnchor.constraint(equalTo: trailingAnchor),
        photoImageView.bottomAnchor.constraint(equalTo: bottomAnchor)
    ])
}

3. 快速验证：先给Cell本身设置背景色 #

如果还是看不到效果，可以先给HomePostCell本身设置背景色，排除imageView的问题：

override init(frame: CGRect) {
    super.init(frame: frame)
    backgroundColor = .lightGray // 先让Cell本身显示出来
    // ... 其他代码
}

如果能看到灰色单元格，说明问题出在imageView的约束上；如果还是看不到，那就要检查CollectionView的初始化是否正确（比如是否在代码或Storyboard里正确关联了dataSource和delegate）。

完整修正后的代码示例 #

HomeController代码 #

import UIKit

class HomeController: UICollectionViewController {
    let cellId = "cellId"
    
    override func viewDidLoad() {
        super.viewDidLoad()
        collectionView?.backgroundColor = .white
        collectionView?.register(HomePostCell.self, forCellWithReuseIdentifier: cellId)
        
        // 配置流水布局参数
        guard let flowLayout = collectionView?.collectionViewLayout as? UICollectionViewFlowLayout else { return }
        flowLayout.itemSize = CGSize(width: view.bounds.width, height: 200)
        flowLayout.minimumInteritemSpacing = 0
        flowLayout.minimumLineSpacing = 8
    }
    
    override func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return 5
    }
    
    override func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: cellId, for: indexPath) as! HomePostCell
        return cell
    }
}

HomePostCell代码 #

import UIKit

class HomePostCell: UICollectionViewCell {
    let photoImageView: UIImageView = {
        let iv = UIImageView()
        iv.backgroundColor = .blue
        iv.translatesAutoresizingMaskIntoConstraints = false
        return iv
    }()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        addSubview(photoImageView)
        
        // 使用系统原生约束API
        NSLayoutConstraint.activate([
            photoImageView.topAnchor.constraint(equalTo: topAnchor),
            photoImageView.leadingAnchor.constraint(equalTo: leadingAnchor),
            photoImageView.trailingAnchor.constraint(equalTo: trailingAnchor),
            photoImageView.bottomAnchor.constraint(equalTo: bottomAnchor)
        ])
    }
    
    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
}

按照上面的修改，你应该能看到5个蓝色的单元格了。

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