如何向Collection View Cell中添加UIViewController？求具备良好内存管理与控制器复用能力的实现示例

当然可以！我之前在项目里正好实现过类似的需求，下面是一套兼顾内存管理和ViewController复用的成熟方案，亲测稳定：

直接给CollectionViewCell添加ViewController的核心是正确管理VC的生命周期+配合CollectionView的复用机制。不能简单把VC的view直接塞到cell里，否则会出现内存泄漏、生命周期异常、复用错乱等问题。我们需要通过容器视图承载VC，并利用UIKit的addChildViewController系列方法来维护VC的生命周期绑定。

1. 自定义支持VC寄宿的CollectionViewCell #

先封装一个专门用来承载ViewController的Cell，内置容器视图和VC管理逻辑：

import UIKit

class ViewControllerHostCell: UICollectionViewCell {
    // 承载VC视图的容器，避免直接操作contentView
    private let containerView = UIView()
    
    // 当前持有的VC，强引用确保VC不会被提前释放
    private(set) var hostedViewController: UIViewController?
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupContainerView()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupContainerView()
    }
    
    private func setupContainerView() {
        containerView.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(containerView)
        NSLayoutConstraint.activate([
            containerView.topAnchor.constraint(equalTo: contentView.topAnchor),
            containerView.leadingAnchor.constraint(equalTo: contentView.leadingAnchor),
            containerView.trailingAnchor.constraint(equalTo: contentView.trailingAnchor),
            containerView.bottomAnchor.constraint(equalTo: contentView.bottomAnchor)
        ])
    }
    
    // 外部调用此方法配置Cell对应的VC
    func configure(with viewController: UIViewController, parentViewController: UIViewController) {
        // 复用前先清理旧VC
        if let existingVC = hostedViewController {
            existingVC.willMove(toParent: nil)
            existingVC.view.removeFromSuperview()
            existingVC.removeFromParent()
            hostedViewController = nil
        }
        
        // 绑定新VC的生命周期
        hostedViewController = viewController
        parentViewController.addChild(viewController)
        viewController.view.translatesAutoresizingMaskIntoConstraints = false
        containerView.addSubview(viewController.view)
        
        // 约束VC的视图充满容器
        NSLayoutConstraint.activate([
            viewController.view.topAnchor.constraint(equalTo: containerView.topAnchor),
            viewController.view.leadingAnchor.constraint(equalTo: containerView.leadingAnchor),
            viewController.view.trailingAnchor.constraint(equalTo: containerView.trailingAnchor),
            viewController.view.bottomAnchor.constraint(equalTo: containerView.bottomAnchor)
        ])
        
        viewController.didMove(toParent: parentViewController)
    }
    
    // CollectionView复用Cell前的清理逻辑
    override func prepareForReuse() {
        super.prepareForReuse()
        // 彻底移除旧VC，避免内存泄漏和布局错乱
        if let existingVC = hostedViewController {
            existingVC.willMove(toParent: nil)
            existingVC.view.removeFromSuperview()
            existingVC.removeFromParent()
            hostedViewController = nil
        }
    }
}

2. 在主ViewController中实现CollectionView逻辑 #

接下来在你的主页面里，配置CollectionView并绑定数据源：

class MainViewController: UIViewController, UICollectionViewDataSource, UICollectionViewDelegateFlowLayout {
    private let collectionView = UICollectionView(frame: .zero, collectionViewLayout: UICollectionViewFlowLayout())
    
    // 模拟数据源：这里可以是不同业务类型的ViewController
    private var vcDataSource: [UIViewController] = [
        UserProfileViewController(),
        ProductCardViewController(),
        CommentListViewController()
    ]
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupCollectionView()
    }
    
    private func setupCollectionView() {
        collectionView.translatesAutoresizingMaskIntoConstraints = false
        view.addSubview(collectionView)
        
        // 约束CollectionView充满屏幕
        NSLayoutConstraint.activate([
            collectionView.topAnchor.constraint(equalTo: view.topAnchor),
            collectionView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            collectionView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            collectionView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
        ])
        
        // 注册自定义Cell
        collectionView.register(ViewControllerHostCell.self, forCellWithReuseIdentifier: "ViewControllerHostCell")
        collectionView.dataSource = self
        collectionView.delegate = self
        
        // 配置FlowLayout
        if let layout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout {
            layout.itemSize = CGSize(width: view.bounds.width, height: 250)
            layout.minimumLineSpacing = 15
        }
    }
    
    // MARK: - UICollectionView数据源方法
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return vcDataSource.count
    }
    
    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "ViewControllerHostCell", for: indexPath) as! ViewControllerHostCell
        let targetVC = vcDataSource[indexPath.item]
        // 给Cell配置对应的VC，传入当前主VC作为父容器
        cell.configure(with: targetVC, parentViewController: self)
        return cell
    }
}

3. 进阶优化：VC复用池（可选） #

如果你的场景需要大量重复创建同类型VC，可以自己维护一个复用池，避免频繁初始化和销毁VC，提升性能：

extension MainViewController {
    // 按VC标识符缓存可复用的VC
    private var vcReusePool: [String: UIViewController] = [:]
    
    // 取出可复用的VC
    func dequeueReusableVC(withIdentifier identifier: String) -> UIViewController? {
        guard let vc = vcReusePool[identifier] else { return nil }
        vcReusePool.removeValue(forKey: identifier)
        return vc
    }
    
    // 将闲置VC放回复用池
    func enqueueReusableVC(_ vc: UIViewController, withIdentifier identifier: String) {
        vcReusePool[identifier] = vc
    }
}

之后在cellForItemAt里，就可以优先从复用池取VC，没有再创建新的。

• 生命周期必须正确绑定：一定要用addChild、didMove(toParent:)等方法，否则VC的viewWillAppear、viewDidDisappear等生命周期方法不会正常触发，内部逻辑容易出问题。
• 复用前必须清理旧VC：在prepareForReuse里彻底移除旧VC的视图和生命周期绑定，避免内存泄漏和多个VC视图叠加。
• 约束要完整：确保VC的视图和容器视图的约束覆盖四边，避免布局错乱。

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