iOS Tab Bar切换ViewController滑动动画导致TableView布局异常

这个问题我之前做类似交互时也碰到过，核心原因是你直接把目标ViewController的视图（toView）加到fromView的父视图里时，没有正确处理视图的布局适配，绕过了TabBarController原本的布局管理逻辑，导致目标VC的TableView顶部约束没有正确生效。

问题根源 #

默认情况下，TabBarController会自动为每个子ViewController的视图设置正确的frame，包括避开顶部布局指南（或者iOS11+的安全区域）。但你手动调用addSubview(toView)并直接修改frame.origin.x时，只处理了水平方向的位置，却忽略了垂直方向的布局偏移——toView的y轴起始位置默认是0，而不是TabBarController管理时的topLayoutGuide.length（或安全区域顶部偏移），这就导致TableView的顶部约束跟着错位，看起来像是重叠了顶部布局指南。另外，你的动画完成后没有正确清理旧视图的层级，也会导致后续布局混乱。

解决方案 #

我给你调整一下动画实现，同时确保布局逻辑正确：

1. 修正动画函数，处理视图的正确frame和层级清理

func tabBarController(_ tabBarController: UITabBarController, shouldSelect viewController: UIViewController) -> Bool {
    // 避免重复点击同一个Tab
    guard let fromController = tabBarController.selectedViewController, 
          fromController != viewController else {
        return true
    }
    animateSliding(from: fromController, to: viewController, in: tabBarController)
    return true
}

func animateSliding(from fromController: UIViewController, 
                    to toController: UIViewController, 
                    in tabBarController: UITabBarController) {
    let fromView = fromController.view
    let toView = toController.view
    let screenBounds = UIScreen.main.bounds
    
    // 计算目标视图的正确初始Frame，避开顶部和底部的布局指南/安全区域
    var toFrame = screenBounds
    if #available(iOS 11.0, *) {
        let safeAreaInsets = tabBarController.view.safeAreaInsets
        toFrame.origin.y = safeAreaInsets.top
        toFrame.size.height = screenBounds.height - safeAreaInsets.top - safeAreaInsets.bottom
    } else {
        toFrame.origin.y = tabBarController.topLayoutGuide.length
        toFrame.size.height = screenBounds.height - tabBarController.topLayoutGuide.length - tabBarController.bottomLayoutGuide.length
    }
    toView.frame = toFrame
    toView.frame.origin.x = screenBounds.width // 初始位置在屏幕右侧
    
    // 将目标视图添加到TabBarController的根视图上，而不是fromView的父视图
    tabBarController.view.addSubview(toView)
    
    // 执行滑动动画
    UIView.animate(withDuration: 0.3, animations: {
        toView.frame.origin.x = 0
        fromView.frame.origin.x = -screenBounds.width
    }) { _ in
        // 动画完成后清理旧视图，让TabBarController接管新视图的管理
        fromView.removeFromSuperview()
        tabBarController.selectedViewController = toController
    }
}

2. 确保子ViewController的TableView约束正确
   检查每个子VC的TableView的顶部约束，要绑定到自身的topLayoutGuide.bottom（iOS10及以下）或safeAreaLayoutGuide.top（iOS11+），而不是直接绑定到VC视图的top。这样无论视图的frame怎么变化，TableView都会自动避开顶部布局指南。

关键说明 #

• 我把toView添加到了TabBarController的根视图上，而不是fromView的父视图，这样更符合TabBarController的视图层级逻辑。
• 手动计算了toView的正确frame，包括垂直方向的偏移，确保视图从顶部布局指南下方开始，TableView的约束自然就能正确生效。
• 动画完成后移除了旧视图，并让TabBarController的selectedViewController指向目标VC，保证后续的布局更新、交互逻辑都能正常工作。

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