iOS开发问题：合并两个ViewController内容到单视图无法渲染

核心问题分析 #

通过UITableView的didSelectRowAt方法跳转到容器控制器CommonViewController时，其内部的DetailsViewController和SmiliarViewController（推测为Similar拼写笔误）子视图控制器内容无法渲染，但单独跳转这两个控制器功能正常——大概率是容器控制器添加子控制器的流程不规范，导致子控制器生命周期未正确触发，或子视图布局约束未正确设置。

必查错误点与修复方案 #

1. 严格遵循子控制器添加的完整流程 #

容器控制器添加子控制器必须执行以下4步，缺一不可：

// 1. 将子控制器添加到父容器
addChild(childVC)
// 2. 将子控制器的view添加到父视图层级
view.addSubview(childVC.view)
// 3. 通知子控制器已完成父容器关联
childVC.didMove(toParent: self)
// 4. 强制关闭自动布局转换，设置明确的约束（核心步骤）
childVC.view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    childVC.view.topAnchor.constraint(equalTo: self.view.topAnchor), // 根据实际布局调整锚点
    childVC.view.leadingAnchor.constraint(equalTo: self.view.leadingAnchor),
    childVC.view.trailingAnchor.constraint(equalTo: self.view.trailingAnchor),
    childVC.view.bottomAnchor.constraint(equalTo: self.view.bottomAnchor)
])

若缺少didMove(toParent:)或未设置布局约束，子控制器的viewDidLoad可能不会触发，或视图被移出屏幕可视范围。

2. 确认子控制器添加时机 #

不要在init等未触发视图初始化的方法中添加子控制器，必须放在viewDidLoad或viewWillAppear中：

override func viewDidLoad() {
    super.viewDidLoad()
    setupChildViewControllers() // 在这里执行添加子控制器的逻辑
}

3. 验证数据传递的完整性 #

单独跳转子控制器正常说明数据逻辑无问题，但容器跳转时需确保选中行的数据同步传递给内部子控制器：

// didSelectRowAt中的跳转代码示例
func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    let selectedModel = dataSource[indexPath.row]
    let commonVC = CommonViewController()
    // 必须给子控制器传递所需数据
    commonVC.detailsVC.viewModel = DetailsViewModel(model: selectedModel)
    commonVC.similarVC.viewModel = SimilarViewModel(model: selectedModel)
    navigationController?.pushViewController(commonVC, animated: true)
}

若子控制器依赖外部传入数据渲染，但容器跳转时未传递，会直接导致空白。

4. 排查子视图是否被遮挡或未正确渲染 #

给子控制器的view设置显眼背景色（如detailsVC.view.backgroundColor = .systemPink），若跳转后能看到背景色，说明子视图存在，但内部列表控件（UITableView/UICollectionView）未渲染，需检查：

• 列表控件的布局约束是否完整
• 列表数据源是否在viewDidLoad之后才完成赋值（比如网络请求回调中刷新）

5. 强制触发子控制器视图刷新 #

若以上步骤均无问题，可在容器控制器的viewWillAppear中强制刷新子控制器的列表：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    detailsVC.tableView.reloadData()
    similarVC.collectionView.reloadData()
}

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