在UITabBarController中创建持久化自定义UIView导航栏的最优方法

我之前也踩过类似的坑，核心问题基本都出在自定义View的层级挂载和UITabBarController的视图生命周期处理上，下面给你一步步拆解解决方案：

一、先理清核心触发原因 #

当加载子视图控制器时，你的自定义View和UITabBarController本身消失，大概率是这两个原因：

• 你在Storyboard里把tabBarArea放在First Responder与Exit之间的区域，这个区域属于控制器的"占位逻辑区"，运行时容易被子控制器的容器视图覆盖
• 隐藏默认tabBar的方式不够稳定，子控制器加载时系统会重置tabBar的状态，连带影响了自定义View的显示

二、分步解决方法 #

1. 把自定义View挂载到正确的层级 #

不要依赖Storyboard的占位区域，直接将tabBarArea添加到UITabBarController的view最顶层，并固定布局：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 稳定隐藏默认tabBar
    tabBar.isHidden = true
    
    // 确保自定义View被添加到当前控制器view的顶层
    self.view.addSubview(tabBarArea)
    // 关闭自动布局转换，手动添加约束固定位置
    tabBarArea.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
        tabBarArea.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        tabBarArea.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        tabBarArea.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
        tabBarArea.heightAnchor.constraint(equalToConstant: 60) // 替换成你的自定义高度
    ])
    
    // 强制把自定义View放在所有子视图之上，防止被覆盖
    self.view.bringSubviewToFront(tabBarArea)
}

2. 重写布局方法，防止子控制器加载时布局错乱 #

子控制器加载会触发UITabBarController的viewWillLayoutSubviews，这里要强制维持自定义View的状态：

override func viewWillLayoutSubviews() {
    super.viewWillLayoutSubviews()
    
    // 确保默认tabBar始终隐藏
    tabBar.isHidden = true
    
    // 再次确认自定义View在顶层
    if tabBarArea.superview == self.view {
        self.view.bringSubviewToFront(tabBarArea)
    }
}

3. 修正子控制器的布局延伸设置 #

避免子控制器的视图延伸覆盖到自定义View区域，在子控制器的viewDidLoad中添加：

override func viewDidLoad() {
    super.viewDidLoad()
    // 禁止视图延伸到安全区域底部（也就是你的自定义View所在区域）
    edgesForExtendedLayout = [.top, .left, .right]
}

三、额外排查点 #

• 检查Storyboard中UITabBarController的Simulated Metrics设置，确保底部栏的模拟高度和你的自定义View高度匹配
• 如果是通过自定义容器加载子控制器，确认没有误将UITabBarController的view从父视图中移除

这样处理后，自定义的tabBarArea应该就能稳定显示，不会随着子控制器加载而消失了。

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