无Storyboard的UIKit项目popViewController时界面UI重叠问题求助

问题演示：

现有蓝色ViewController与白色ViewController两种页面：

• 点击蓝色页面的按钮，通过Push方式进入白色ViewController；
• 白色ViewController内有一个大轮盘组件，仅在白色页面显示一半；
• 点击白色页面特定按钮执行popViewController操作时，白色页面的大轮盘有一半会重叠显示在蓝色页面上。

项目背景：

• 基于无Storyboard的UIKit代码库开发；
• 采用Coordinator模式；
• 通过创建Navigation Controller实现页面Push跳转。

此前使用Storyboard开发时未出现该问题，需要设置哪些选项来解决此UI重叠问题？

这种UI重叠问题核心是轮盘组件未随白色ViewController的销毁/消失正确隐藏或裁剪，以下是针对性的解决方法：

1. 修正轮盘组件的父视图归属 #

确保轮盘组件是添加到白色ViewController的view层级下，而非全局UIWindow或Navigation Controller的视图中。如果错误添加到全局层级，pop操作不会自动移除该组件：

// 正确方式
whiteVC.view.addSubview(wheelView)
// 错误方式（会导致重叠）
UIApplication.shared.keyWindow?.addSubview(wheelView)

2. 利用生命周期方法控制组件显示 #

在白色ViewController的生命周期方法中，手动隐藏或移除轮盘组件：

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    wheelView.isHidden = true
    // 或者直接移除（若后续不再复用）
    // wheelView.removeFromSuperview()
}

3. 开启视图裁剪属性 #

给白色ViewController的view设置clipsToBounds = true，超出视图范围的子视图会被自动裁剪，不会泄露到父页面：

whiteVC.view.clipsToBounds = true

如果轮盘是嵌套在某个容器视图内，同样需要给该容器视图设置此属性。

4. 匹配Storyboard的默认布局配置 #

Storyboard创建的ViewController会自带一些默认布局属性，手动代码创建时需同步这些配置，避免布局范围异常：

whiteVC.edgesForExtendedLayout = .all
whiteVC.extendedLayoutIncludesOpaqueBars = false

5. 检查Coordinator的页面跳转逻辑 #

确认Coordinator中push和pop的逻辑没有错误持有白色ViewController的引用，导致其视图未被正确释放；若使用自定义转场动画，需确保动画结束后完整清理白色ViewController的视图层级。

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