Swift 5 如何隐藏导航栏返回按钮或实现无返回按钮页面跳转

优先确认视图控制器绑定关系 #

• 若使用Storyboard/Xib开发：打开对应页面的身份检查器，将自定义类设置为你编写的ViewController，类名拼写必须完全匹配，否则你写的所有生命周期代码不会执行，这是配置全不生效的最高发原因。
• 若使用纯代码开发：跳转时必须手动实例化你自定义的ViewController类，不能错用基类UIViewController，正确跳转代码如下：

let targetPage = ViewController()
navigationController?.pushViewController(targetPage, animated: true)

清理冗余冲突配置 #

你当前代码堆叠了大量重复、冲突的配置，反而会导致导航栏状态异常：

• 不要同时调用navigationController?.navigationBar.isHidden = true和返回按钮隐藏方法，前者是隐藏整个导航栏，会影响导航栈内所有页面的导航栏状态，和单页面隐藏返回按钮的需求冲突。
• 不需要在viewDidLoad、viewWillAppear、viewDidAppear三个生命周期重复写相同配置，重复触发状态更新反而可能被系统后续的导航栏刷新逻辑覆盖。

标准实现方案 #

场景1：仅隐藏当前页面返回按钮，保留导航栏其他元素 #

只需要在目标页面的viewWillAppear中添加一行核心代码即可：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    navigationItem.hidesBackButton = true
}

场景2：原生方法被自定义导航栏/第三方组件拦截 #

如果项目里做了全局导航栏自定义、或者集成了第三方导航栏组件，原生hidesBackButton属性可能被覆盖，直接用空自定义视图覆盖左侧返回按钮即可：

override func viewDidLoad() {
    super.viewDidLoad()
    // 用空视图替换左侧按钮项，覆盖系统返回按钮
    navigationItem.leftBarButtonItem = UIBarButtonItem(customView: UIView())
    // 如果需要同时禁掉侧滑返回手势，解开下面注释
    // navigationController?.interactivePopGestureRecognizer?.isEnabled = false
}

场景3：需要完全隐藏当前页面整个导航栏 #

不要直接改navigationBar.isHidden属性，用导航控制器的显隐方法，同时记得在页面退出时恢复导航栏状态，避免影响其他页面：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    navigationController?.setNavigationBarHidden(true, animated: animated)
}

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    navigationController?.setNavigationBarHidden(false, animated: animated)
}

场景4：SwiftUI混编页面适配 #

你代码中导入了SwiftUI，如果目标页面是通过UIHostingController包裹的SwiftUI视图，上述UIKit配置不会生效，直接在SwiftUI视图中添加导航栏修饰符：

struct TargetPageView: View {
    var body: some View {
        Text("目标页面内容")
            .navigationBarBackButtonHidden(true)
    }
}

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