深入理解 UITabBarController：代理方法与 ViewController 生命周期的执行顺序（含 UINavigationController 场景）

在 iOS 开发中，UITabBarController 是构建多 Tab 应用的标准容器。但很多开发者对以下问题仍模糊不清：

• tabBarController:shouldSelectViewController: 和 didSelectViewController: 到底在什么时候调用？
• tabBarController.selectedViewController 何时发生变化？
• 如果每个 Tab 都是 UINavigationController，代理拿到的是谁？生命周期又由谁接收？
• 如何准确获取“切换前”和“切换后”的业务控制器？

本文将通过精确的时间线 + 状态快照 + 实战代码，彻底厘清 UITabBarController 在用户点击 Tab 时的完整执行链，助你写出精准、健壮的导航逻辑。

---

🔑 核心概念：selectedViewController 的变化时机

UITabBarController 有一个关键属性：

@property(nullable, nonatomic, weak) UIViewController *selectedViewController;

它的值不是在切换开始时变，而是在切换完成后才更新。这一点直接决定了你在代理中能拿到什么。

✅ 结论先行：

• 在 shouldSelectViewController: 中，selectedViewController 仍是旧的控制器
• 在 didSelectViewController: 中，selectedViewController 已等于新控制器
• 真正的赋值发生在 ViewController 转场完成之后、didSelect 调用之前

这个特性，是实现“记录切换来源”的关键！

---

📋 一、标准执行流程（从 Tab A → Tab B）

假设：

• 当前选中的是 A 控制器
• 用户点击 Tab，切换到 B 控制器
• 所有 view 已加载（非首次）
• tabBarController.delegate = self

✅ 完整执行顺序 + selectedViewController 快照

步骤	方法 / 事件	selectedViewController 的值	说明
1	shouldSelectViewController:(B)	A	可拦截切换；此时 B 尚未激活
2	A.viewWillDisappear:	A	A 即将消失
3	B.viewWillAppear:	A	B 即将出现，但 TabBar 仍认为 A 是当前页
4	A.viewDidDisappear:	A	A 已消失
5	B.viewDidAppear:	A	B 已显示，但 selectedViewController 仍未更新！
6	内部赋值	B	UIKit 私有逻辑：selectedViewController = B
7	didSelectViewController:(B)	B	切换完成，可安全使用新控制器

💡 重点：selectedViewController 的变更发生在 viewDidAppear: 之后、didSelect... 之前。

这意味着：

• 你不能在 viewDidAppear: 中通过 tabBarController.selectedViewController 判断“是否刚被选中”（因为它还是旧的！）
• 但你可以在 shouldSelect... 中通过 selectedViewController 获取“切换前”的控制器

---

📦 二、当 Tab 中是 UINavigationController 时

这是最常见架构：

TabBarController
├── UINavigationController (rootVC of Tab 0) → HomeVC
└── UINavigationController (rootVC of Tab 1) → ProfileVC

🔄 执行流程是否改变？

否！顺序完全一致，但对象类型不同：

阶段	普通 VC 场景	UINavigationController 场景
shouldSelect... 参数	HomeVC	UINavigationController
selectedViewController	HomeVC	UINavigationController
生命周期接收者	HomeVC	HomeVC（Nav 的 topViewController）
didSelect... 参数	HomeVC	UINavigationController

✅ 示例：代理中的日志

- (BOOL)tabBarController:(UITabBarController *)tc shouldSelectViewController:(UIViewController *)toRoot {
    UIViewController *fromRoot = tc.selectedViewController; // 仍是旧的 Nav
    NSLog(@"[shouldSelect] from: %@, to: %@", 
          NSStringFromClass([fromRoot class]), 
          NSStringFromClass([toRoot class]));
    // 输出：from: UINavigationController, to: UINavigationController
    return YES;
}

而与此同时，HomeVC 会正常收到 viewWillAppear:，因为 UINavigationController 会自动将生命周期传递给其 topViewController。

---

🛠 三、如何正确获取“业务控制器”？

由于 delegate 拿到的是 root VC（可能是 Nav），我们需要“穿透”一层。

✅ 推荐工具方法：

- (UIViewController *)businessViewControllerFromTabRoot:(UIViewController *)root {
    if ([root isKindOfClass:[UINavigationController class]]) {
        return [(UINavigationController *)root topViewController];
    }
    return root;
}

应用于代理：

- (BOOL)tabBarController:(UITabBarController *)tc shouldSelectViewController:(UIViewController *)toRoot {
    UIViewController *fromBusiness = [self businessViewControllerFromTabRoot:tc.selectedViewController];
    UIViewController *toBusiness   = [self businessViewControllerFromTabRoot:toRoot];
    
    NSLog(@"从 %@ 切换到 %@", 
          NSStringFromClass([fromBusiness class]), 
          NSStringFromClass([toBusiness class]));
    
    // 缓存“切换前”用于 didSelect
    self.previousBusinessVC = fromBusiness;
    
    return YES;
}

- (void)tabBarController:(UITabBarController *)tc didSelectViewController:(UIViewController *)toRoot {
    UIViewController *toBusiness = [self businessViewControllerFromTabRoot:toRoot];
    UIViewController *fromBusiness = self.previousBusinessVC;
    
    [Analytics logTabSwitchFrom:fromBusiness to:toBusiness];
}

⚠️ 注意：不要在 didSelect... 中再读 tc.selectedViewController 来获取“from”，因为它已经是 to 了！

---

⚠️ 四、特殊场景深度解析

1. 重复点击当前 Tab（A → A）

• ✅ shouldSelectViewController: 被调用，selectedViewController == toRoot
• ❌ 不触发任何生命周期方法
• ❌ 不调用 didSelectViewController:
• ❌ 不会修改 selectedViewController（本来就是它）

✅ 用途：实现“回到顶部”、“刷新当前页”

- (BOOL)tabBarController:(UITabBarController *)tc shouldSelectViewController:(UIViewController *)vc {
    if (vc == tc.selectedViewController) {
        if ([vc isKindOfClass:[UINavigationController class]]) {
            [(UINavigationController *)vc popToRootViewControllerAnimated:YES];
        }
        return NO; // 语义上“不需要切换”
    }
    return YES;
}

2. 通过代码切换 Tab（如 selectedIndex = 1）

• ❌ 不触发任何 delegate 方法
• ✅ 但会触发 ViewController 生命周期
• ✅ selectedViewController 会立即更新

所以：delegate 方法仅由用户点击 TabBar 触发

---

📌 五、开发最佳实践总结

需求	推荐位置	注意事项
获取“切换前”的控制器	shouldSelect... 中读 selectedViewController	需解包 UINavigationController
获取“切换后”的控制器	didSelect... 的参数 或 selectedViewController	两者此时相等
刷新数据	业务 VC 的 viewWillAppear:	不要放 viewDidLoad
埋点 / 日志	didSelect...	确保切换已完成
拦截切换	shouldSelect... 返回 NO	可用于权限控制
处理重复点击	shouldSelect... 中判断 vc == selectedViewController	可手动触发逻辑

---

✅ 六、终极流程图（含状态快照）

用户点击 Tab B
        ↓
[Delegate] shouldSelectViewController:(B_root)
    → selectedViewController == A_root ✅
        ↓
[A_business] viewWillDisappear
[B_business] viewWillAppear
        ↓
[A_business] viewDidDisappear
[B_business] viewDidAppear
        ↓
UIKit 内部: tabBarController.selectedViewController = B_root
        ↓
[Delegate] didSelectViewController:(B_root)
    → selectedViewController == B_root ✅

🎯 记住三句话：

1. shouldSelect 看“过去”，didSelect 看“现在”
2. 生命周期属于业务 VC，代理参数属于 Tab root VC
3. selectedViewController 的变更，发生在转场结束之后

---

📚 结语

UITabBarController 的设计精巧而一致。只要理解 代理时机、selectedViewController 变化点、以及 UINavigationController 的穿透逻辑，你就能在任何复杂 Tab 架构中游刃有余。

希望本文能成为你处理 Tab 切换逻辑的“黄金参考”。

---

欢迎点赞、收藏、评论交流！如果你有更复杂的嵌套场景（如 Tab 内嵌 PageViewController），也欢迎留言讨论！