通过Xib创建UITabBarController出现黑屏问题求助

我之前也碰到过一模一样的坑！用Xib做UITabBarController确实容易忽略几个关键配置，我帮你梳理下必须检查的步骤和排查方向：

1. 先确认Xib的基础配置没搞错 #

• 新建Xib时一定要选Tab Bar Controller模板，别选普通的ViewController或View！这个模板会自动帮你生成带UITabBar的控制器结构，手动搭很容易出问题。
• 重点看File's Owner：把它的类设置为你的自定义UITabBarController子类，Xib里的Tab Bar Controller对象本身不用改类，它就是控制器的view部分——很多人搞反这俩导致加载失败。

2. 正确关联子控制器和Tab项 #

• 在Xib里选中Tab Bar Controller，到Attributes Inspector的View Controllers列表里逐个添加子控制器。
• 给每个子控制器设置好Tab Bar Item的标题、图标，同时如果子控制器也是Xib创建的，要么保证子控制器的类名和Xib文件名完全一致，要么后面在代码里手动指定加载哪个Xib。
• 要是你在Xib里关联的子控制器没正常显示，试试在自定义UITabBarController的awakeFromNib里补全加载逻辑：

override func awakeFromNib() {
    super.awakeFromNib()
    
    // 示例：如果第一个子控制器是HomeVC，Xib名和类名一致
    if let homeVC = viewControllers?.first as? HomeViewController {
        homeVC.loadViewIfNeeded()
    }
    // 如果Xib名和类名不一样，就手动初始化替换：
    // let profileVC = ProfileViewController(nibName: "CustomProfileXib", bundle: nil)
    // profileVC.tabBarItem.title = "我的"
    // viewControllers?.append(profileVC)
}

3. 设置根控制器的姿势要对 #

别直接init()控制器，一定要通过Xib加载：

// iOS13+ 在SceneDelegate的scene(_:willConnectTo:options:)里
guard let windowScene = (scene as? UIWindowScene) else { return }
let window = UIWindow(windowScene: windowScene)
let tabBarVC = CustomTabBarController(nibName: "你的TabBarXib文件名", bundle: nil)
window.rootViewController = tabBarVC
self.window = window
window.makeKeyAndVisible()

要是用的是旧版AppDelegate，逻辑类似，确保通过nibName初始化控制器。

4. 黑屏的常见排查点 #

• 检查Xib的Size Inspector：把Simulated Size设为Inferred或Freeform，固定尺寸可能导致view适配错误。
• 别乱重写loadView()：如果自定义UITabBarController里重写了这个方法，一定要调用super.loadView()，否则会覆盖Xib加载的view，直接黑屏。
• 子控制器也要检查：看看子控制器的Xib有没有正确关联view，或者是不是把view的背景色设成透明了——有时候不是TabBar的问题，是子控制器没显示。

5. 加日志验证加载情况 #

在自定义UITabBarController的viewDidLoad里加两行打印，快速定位问题：

override func viewDidLoad() {
    super.viewDidLoad()
    print("TabBar视图是否存在：\(view)")
    print("子控制器数量：\(viewControllers?.count ?? 0)")
}

如果子控制器数量是0，说明Xib里的关联完全没生效，回去重新配置View Controllers列表就行。

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