iOS中为UITabBarController添加子控制器不生成“幽灵”Tab项的方法

针对你遇到的幽灵Tab项、交互遮挡以及iOS18适配问题，以下是三种针对性的解决思路：

一、优化子控制器添加逻辑（彻底避免幽灵Tab） #

核心是不将悬浮控制器加入UITabBarController的viewControllers数组，仅将其视图添加到TabBarController的视图层级中，同时正确处理生命周期与布局：

func presentFloatingViewController(to tabBarController: UITabBarController) {
    let floatingVC = UIViewController()
    // 根据需求自定义悬浮视图样式，比如半透明背景
    floatingVC.view.backgroundColor = UIColor.black.withAlphaComponent(0.3)
    
    tabBarController.addChild(floatingVC)
    tabBarController.view.addSubview(floatingVC.view)
    
    // 用AutoLayout替代frame，适配全屏幕尺寸
    floatingVC.view.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
        floatingVC.view.topAnchor.constraint(equalTo: tabBarController.view.topAnchor),
        floatingVC.view.leadingAnchor.constraint(equalTo: tabBarController.view.leadingAnchor),
        floatingVC.view.trailingAnchor.constraint(equalTo: tabBarController.view.trailingAnchor),
        floatingVC.view.bottomAnchor.constraint(equalTo: tabBarController.tabBar.topAnchor) // 避开TabBar区域，确保Tab可交互
    ])
    
    // 若需要悬浮视图覆盖TabBar但不阻挡交互，可设置：
    // floatingVC.view.isUserInteractionEnabled = false
    // 悬浮视图内需要交互的控件单独开启isUserInteractionEnabled = true
    
    floatingVC.didMove(toParent: tabBarController)
}

关键说明： #

• 仅通过addChild添加子控制器，不修改tabBarController.viewControllers，从根源避免幽灵Tab项生成
• 通过约束避开TabBar区域，或关闭悬浮视图的整体交互，保证TabBar及下层视图的触摸响应正常

二、改进模态展示实现交互穿透 #

针对模态方案的遮挡问题，通过调整展示样式与交互属性，让事件可以穿透到下层：

func presentFloatingModal(from tabBarController: UITabBarController) {
    let floatingVC = UIViewController()
    floatingVC.view.backgroundColor = UIColor.clear // 背景设为透明
    floatingVC.modalPresentationStyle = .overFullScreen
    floatingVC.modalTransitionStyle = .crossDissolve
    
    // 关闭悬浮视图的整体交互，让触摸事件穿透到下层TabBar和内容
    floatingVC.view.isUserInteractionEnabled = false
    // 若悬浮视图内有需要交互的控件，单独设置该控件的isUserInteractionEnabled = true
    
    tabBarController.present(floatingVC, animated: true)
}

关键说明： #

• 使用.overFullScreen确保覆盖整个屏幕，同时保留下层视图的存在
• 通过关闭悬浮视图的交互，解决UITransitionView遮挡问题，下层TabBar可正常响应

三、iOS18适配方案：绑定到当前Tab子控制器 #

iOS18对UITabBarController的子控制器逻辑有更新，直接添加到TabBarController可能再次出现幽灵Tab，建议将悬浮控制器绑定到当前选中的Tab子控制器：

func presentFloatingOnCurrentTab(from tabBarController: UITabBarController) {
    guard let currentTabVC = tabBarController.selectedViewController else { return }
    
    let floatingVC = UIViewController()
    currentTabVC.addChild(floatingVC)
    currentTabVC.view.addSubview(floatingVC.view)
    
    floatingVC.view.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
        floatingVC.view.topAnchor.constraint(equalTo: currentTabVC.view.topAnchor),
        floatingVC.view.leadingAnchor.constraint(equalTo: currentTabVC.view.leadingAnchor),
        floatingVC.view.trailingAnchor.constraint(equalTo: currentTabVC.view.trailingAnchor),
        floatingVC.view.bottomAnchor.constraint(equalTo: currentTabVC.view.bottomAnchor)
    ])
    
    // 确保TabBar始终在最上层，不受悬浮视图遮挡
    tabBarController.view.bringSubviewToFront(tabBarController.tabBar)
    
    floatingVC.didMove(toParent: currentTabVC)
}

关键说明： #

• 将悬浮控制器添加到当前活跃的Tab子控制器，完全脱离TabBarController的Tab选项管理逻辑
• 通过bringSubviewToFront强制TabBar保持在最上层，保证交互与UI完整性

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