iOS开发：调用popToRootViewController无法返回带导航栏的根视图

1. 检查根ViewController的导航栏显示状态 #

打开你跳转后回到的根ViewController，查看它的生命周期方法（如viewWillAppear、viewDidLoad）里是否有主动隐藏导航栏的代码：

// 错误示例：这类代码会导致回到根VC时导航栏被隐藏
navigationController?.setNavigationBarHidden(true, animated: false)

如果存在，要么直接删除，要么改成确保根VC显示导航栏的逻辑：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    // 强制根VC显示导航栏
    navigationController?.setNavigationBarHidden(false, animated: animated)
}

2. 验证导航控制器的栈结构 #

在调用popToRootViewController前，先打印导航栈内容，确认根VC确实是导航控制器的初始根节点：

print("当前导航栈：\(self.navigationController?.viewControllers ?? [])")
let returnedVCs = self.navigationController?.popToRootViewController(animated: true)
print("跳转后回到的VC：\(returnedVCs ?? [])")

如果打印结果里的根VC不是你预期的页面，说明导航栈被意外修改过（比如中途替换了栈内控制器），需要排查跳转逻辑。

3. 检查导航栏全局隐藏设置 #

查看SceneDelegate中初始化导航控制器的代码，确认没有全局隐藏导航栏：

// 错误示例：这类代码会导致整个导航控制器的导航栏隐藏
navVC.navigationBar.isHidden = true

确保导航控制器的导航栏默认处于显示状态，或仅在特定页面动态控制隐藏。

4. 确认根VC的导航栏按钮配置 #

检查根VC的viewDidLoad方法，是否正确设置了导航栏按钮和标题：

override func viewDidLoad() {
    super.viewDidLoad()
    // 设置导航栏右侧按钮
    let rightBtn = UIBarButtonItem(title: "操作", style: .done, target: self, action: #selector(rightBtnTapped))
    navigationItem.rightBarButtonItem = rightBtn
    // 设置导航栏标题
    title = "首页"
}

@objc func rightBtnTapped() {
    // 按钮点击逻辑
}

如果未配置导航栏元素，导航栏自然不会显示按钮或标题。

5. 排查跳转页面的导航栏状态恢复逻辑 #

如果是在某个push出去的VC里隐藏了导航栏（比如为了全屏显示），需要在该VC的viewWillDisappear方法中恢复导航栏显示：

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    // 离开当前页面时恢复导航栏显示
    navigationController?.setNavigationBarHidden(false, animated: animated)
}

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