iOS开发：切换TabBar后返回未关闭PopupViewController出现深色背景的解决办法

嘿，作为iOS开发新手遇到这个问题很正常，我来给你拆解下原因和几个实用的解决办法，一步步来就能搞定：

核心原因分析 #

你大概率是把弹窗（PopupViewController）的视图添加到了TabBar内某个ViewController的view上，当切换Tab时，原ViewController的view会被系统从窗口中移除/隐藏，此时弹窗的视图没有跟随正确的外观环境更新，就会出现背景变深的情况。

方案1：把弹窗挂载到UIWindow上（最稳妥） #

把弹窗的父视图改成全局的UIWindow，这样切换Tab时弹窗不会随原VC的view被隐藏，外观也能保持正常。代码示例如下：

// 获取当前活跃的key window（适配iOS 13+多场景）
guard let keyWindow = UIApplication.shared.connectedScenes
        .filter({ $0.activationState == .foregroundActive })
        .compactMap({ $0 as? UIWindowScene })
        .first?.windows
        .first(where: { $0.isKeyWindow }) else { return }

// 初始化你的弹窗VC
let popupVC = PopupViewController()
popupVC.view.frame = keyWindow.bounds

// 将弹窗添加到window上
keyWindow.addSubview(popupVC.view)
keyWindow.rootViewController?.addChild(popupVC)
popupVC.didMove(toParent: keyWindow.rootViewController)

这样弹窗就脱离了单个Tab的VC视图，始终在全局窗口层级，切换Tab后外观不会异常。

方案2：切换Tab时自动关闭弹窗 #

如果业务允许，切换Tab时直接关闭弹窗，避免残留导致的问题，体验也更符合用户预期。可以通过监听TabBar的切换事件实现：

方法A：用UITabBarControllerDelegate #

class YourTableViewController: UITableViewController {
    // 保存弹窗的引用
    var popupVC: PopupViewController?

    override func viewDidLoad() {
        super.viewDidLoad()
        // 设置TabBarController的代理
        tabBarController?.delegate = self
    }
}

// 实现代理方法
extension YourTableViewController: UITabBarControllerDelegate {
    func tabBarController(_ tabBarController: UITabBarController, shouldSelect viewController: UIViewController) -> Bool {
        // 如果要切换到其他Tab，关闭弹窗
        if viewController != self {
            popupVC?.view.removeFromSuperview()
            popupVC?.removeFromParent()
            popupVC = nil
        }
        return true
    }
}

方法B：直接监听TabBar点击事件 #

override func viewDidLoad() {
    super.viewDidLoad()
    tabBarController?.tabBar.addTarget(self, action: #selector(tabBarTapped), for: .touchUpInside)
}

@objc private func tabBarTapped() {
    guard let selectedIndex = tabBarController?.selectedIndex,
          let currentIndex = tabBarController?.viewControllers?.firstIndex(of: self) else { return }
    
    if selectedIndex != currentIndex {
        // 移除弹窗
        popupVC?.view.removeFromSuperview()
        popupVC?.removeFromParent()
        popupVC = nil
    }
}

方案3：修复弹窗的外观适配 #

如果必须保留弹窗在切换Tab后显示，那要确保弹窗能响应系统外观变化。在你的PopupViewController中添加外观更新逻辑：

class PopupViewController: UIViewController {
    override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {
        super.traitCollectionDidChange(previousTraitCollection)
        // 检测外观模式（深色/浅色）是否变化
        if traitCollection.hasDifferentColorAppearance(comparedTo: previousTraitCollection) {
            // 更新弹窗背景色，用系统动态色适配外观
            view.backgroundColor = .secondarySystemBackground
            // 如果有自定义背景视图，也要同步更新
            customBackgroundView?.backgroundColor = .secondarySystemBackground
        }
    }
}

这个方法能让弹窗在切换Tab后，自动同步当前的外观模式，修正背景颜色异常。

推荐方案 #

对于新手来说，方案1是最省心的，不用处理复杂的生命周期监听，直接从根源避免了问题。

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