iOS开发：如何将导航栏排除在safeAreaLayoutGuide之外？

这个场景我之前做全屏阅读类应用时刚好碰到过，核心问题就是手动隐藏导航栏时，系统的safeAreaLayoutGuide依然会把导航栏的高度算进安全区域，导致按钮位置不符合预期。下面按从简单到复杂的顺序给你几个可行方案：

方案零：用系统原生的导航栏隐藏机制（最推荐） #

如果你的导航栏是通过点击屏幕来切换显示/隐藏的，直接用UINavigationController的hidesBarsOnTap属性就可以解决所有问题——系统会自动帮你处理安全区域的变化：

• 导航栏显示时，safeAreaLayoutGuide的top会自动避开状态栏+导航栏
• 导航栏隐藏时，safeAreaLayoutGuide的top只会避开状态栏（刘海）

代码实现超简单：

override func viewDidLoad() {
    super.viewDidLoad()
    // 开启点击屏幕切换导航栏显示/隐藏
    navigationController?.hidesBarsOnTap = true
    
    // 按钮直接约束到safeArea的top
    let button = UIButton(type: .system)
    button.setTitle("测试按钮", for: .normal)
    button.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(button)
    
    NSLayoutConstraint.activate([
        button.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
        button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
        button.widthAnchor.constraint(equalToConstant: 120),
        button.heightAnchor.constraint(equalToConstant: 44)
    ])
}

这个方案完全符合Apple的设计规范，几乎不需要额外代码，优先考虑！

方案一：调整additionalSafeAreaInsets抵消导航栏高度 #

如果必须手动控制导航栏的显示/隐藏（比如自定义触发逻辑），可以通过调整当前ViewController的additionalSafeAreaInsets来抵消系统safeArea中包含的导航栏高度：

1. 按钮直接约束到safeAreaLayoutGuide.topAnchor
2. 监听导航栏的isHidden状态，动态设置additionalSafeAreaInsets.top：当导航栏隐藏时，设为负的导航栏高度，把系统多算的部分抵消掉；显示时恢复为0

代码示例：

private var navBarHeight: CGFloat {
    navigationController?.navigationBar.frame.height ?? 44 // 默认导航栏高度
}

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 初始化按钮并约束到safeArea
    let button = UIButton(type: .system)
    button.setTitle("测试按钮", for: .normal)
    button.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(button)
    
    NSLayoutConstraint.activate([
        button.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
        button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
        button.widthAnchor.constraint(equalToConstant: 120),
        button.heightAnchor.constraint(equalToConstant: 44)
    ])
    
    // 初始状态调整偏移（如果导航栏默认是隐藏的）
    if navigationController?.navigationBar.isHidden ?? true {
        additionalSafeAreaInsets.top = -navBarHeight
    }
    
    // KVO监听导航栏显示/隐藏状态
    navigationController?.navigationBar.addObserver(self, forKeyPath: #keyPath(UINavigationBar.isHidden), options: [.old, .new], context: nil)
}

override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    guard keyPath == #keyPath(UINavigationBar.isHidden) else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
        return
    }
    
    let isNavBarHidden = change?[.newKey] as? Bool ?? true
    // 动态调整额外安全区域偏移
    additionalSafeAreaInsets.top = isNavBarHidden ? -navBarHeight : 0
    
    // 加上动画让过渡更自然
    UIView.animate(withDuration: 0.3) {
        self.view.layoutIfNeeded()
    }
}

deinit {
    // 记得移除KVO监听，避免内存泄漏
    navigationController?.navigationBar.removeObserver(self, forKeyPath: #keyPath(UINavigationBar.isHidden))
}

注意：如果在viewDidLoad时导航栏的frame还没确定，最好在viewDidAppear里再重新设置一次additionalSafeAreaInsets。

方案二：动态调整按钮的top约束常量 #

如果不想依赖safeArea机制，也可以直接手动控制按钮的top偏移量：

1. 把按钮的top约束到superview的top，常量设为状态栏高度（避开刘海）
2. 监听导航栏状态，当导航栏显示时，把常量加上导航栏高度；隐藏时恢复为状态栏高度

首先实现一个兼容iOS 13+的状态栏高度获取方法：

private var statusBarHeight: CGFloat {
    if #available(iOS 13.0, *) {
        return view.window?.windowScene?.statusBarManager?.statusBarFrame.height ?? 0
    } else {
        return UIApplication.shared.statusBarFrame.height
    }
}

然后是按钮约束和监听逻辑：

private var buttonTopConstraint: NSLayoutConstraint!

override func viewDidLoad() {
    super.viewDidLoad()
    
    let button = UIButton(type: .system)
    button.setTitle("测试按钮", for: .normal)
    button.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(button)
    
    // 初始化按钮top约束：紧贴状态栏下方
    buttonTopConstraint = button.topAnchor.constraint(equalTo: view.topAnchor, constant: statusBarHeight)
    
    NSLayoutConstraint.activate([
        buttonTopConstraint,
        button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
        button.widthAnchor.constraint(equalToConstant: 120),
        button.heightAnchor.constraint(equalToConstant: 44)
    ])
    
    // 监听导航栏状态
    navigationController?.navigationBar.addObserver(self, forKeyPath: #keyPath(UINavigationBar.isHidden), options: [.old, .new], context: nil)
}

override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    guard keyPath == #keyPath(UINavigationBar.isHidden) else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
        return
    }
    
    let isNavBarHidden = change?[.newKey] as? Bool ?? true
    let navBarHeight = navigationController?.navigationBar.frame.height ?? 44
    
    // 更新约束常量
    buttonTopConstraint.constant = statusBarHeight + (isNavBarHidden ? 0 : navBarHeight)
    
    UIView.animate(withDuration: 0.3) {
        self.view.layoutIfNeeded()
    }
}

deinit {
    navigationController?.navigationBar.removeObserver(self, forKeyPath: #keyPath(UINavigationBar.isHidden))
}

这个方案的好处是完全自定义控制位置，适合有特殊布局需求的场景。

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