将Table View Controller嵌入Tab Bar后，导航标题与按钮消失的原因及解决办法

嘿，这个问题我之前帮不少开发者踩过坑，本质是导航控制器的层级结构被打乱了：

• 之前你的TableVC嵌套在Navigation Controller里，此时TableVC的navigationItem（用来设置标题、按钮的核心属性）会直接绑定到Navigation Controller的导航栏上，所以设置后能正常显示。
• 但你直接把TableVC嵌入TabBar Controller后，TableVC就脱离了Navigation Controller的层级。TabBar Controller本身不会为子控制器提供导航栏容器，你设置的标题和按钮自然就没地方展示了。

1. 调整层级结构（最推荐的标准做法） #

你需要把包含TableVC的Navigation Controller作为TabBar Controller的子项，而不是直接把TableVC拖进去：

• 如果用Storyboard操作：选中你的TableVC所在的Navigation Controller，把它拖到TabBar Controller的子控制器列表里；
• 如果用代码操作：设置tabBarController.viewControllers = [你的导航控制器, ...其他Tab对应的导航控制器]。
• 这样每个Tab都对应一个独立的Navigation Controller，TableVC在导航栈中，它的navigationItem设置会正常作用于对应的导航栏，标题和按钮就能正常显示了。

2. 检查代码设置的时机 #

确保你是在TableVC的合适生命周期方法里配置标题和按钮，比如viewDidLoad或者viewWillAppear：

override func viewDidLoad() {
    super.viewDidLoad()
    self.title = "我的列表"
    let addButton = UIBarButtonItem(barButtonSystemItem: .add, target: self, action: #selector(addTapped))
    self.navigationItem.rightBarButtonItem = addButton
}

别在init或者awakeFromNib里设置，因为此时控制器还没关联到导航栏，设置可能不会生效。

3. 应急方案：手动添加导航栏（不推荐） #

如果暂时不想调整层级，可以在TableVC的view里手动添加一个UINavigationBar：

override func viewDidLoad() {
    super.viewDidLoad()
    let navBar = UINavigationBar(frame: CGRect(x: 0, y: view.safeAreaInsets.top, width: view.frame.width, height: 44))
    let navItem = UINavigationItem(title: "我的列表")
    let addButton = UIBarButtonItem(barButtonSystemItem: .add, target: self, action: #selector(addTapped))
    navItem.rightBarButtonItem = addButton
    navBar.setItems([navItem], animated: false)
    view.addSubview(navBar)
    // 记得调整TableView的内边距，避免被导航栏挡住内容
    tableView.contentInset = UIEdgeInsets(top: 44, left: 0, bottom: 0, right: 0)
}

但这种方法会和系统导航栏的交互逻辑冲突（比如无法自动处理返回按钮），所以仅作为临时方案，优先用第一种方法。

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