iOS UINavigationBar标题顶部无间距无法垂直居中如何解决？

核心问题根因 #

• 导航栏硬编码 frame 的y值为0，没有避开顶部安全区（状态栏区域），导致导航栏本身和状态栏重叠，内容自然紧贴屏幕最顶部
• setTitleVerticalPositionAdjustment 传入的数值70过大，远超正常调整范围，反而引发布局异常
• 硬编码导航栏高度为60，不符合iOS系统导航栏的标准适配规则

具体修复步骤 #

1. 改用AutoLayout适配导航栏，避免硬编码frame #

移除原有的硬编码frame逻辑，改用约束适配安全区：

private lazy var navBar: UINavigationBar = {
    let bar = UINavigationBar()
    // 开启AutoLayout
    bar.translatesAutoresizingMaskIntoConstraints = false
    // 垂直偏移先设为0，后续可根据视觉效果微调（范围建议-3~3）
    bar.setTitleVerticalPositionAdjustment(0, for: .default)
    return bar
}()

在 viewDidLoad 中添加导航栏约束：

navBar.tintColor = .white
view.addSubview(navBar)
// 激活约束，适配安全区
NSLayoutConstraint.activate([
    // 导航栏顶部对齐安全区顶部，自动避开状态栏
    navBar.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
    navBar.leadingAnchor.constraint(equalTo: view.leadingAnchor),
    navBar.trailingAnchor.constraint(equalTo: view.trailingAnchor),
    // iOS系统标准导航栏高度为44
    navBar.heightAnchor.constraint(equalToConstant: 44)
])

2. 修正UIBarButtonItem的偏移量 #

原设置的imageInsets top值为16，会将按钮过度下压，影响导航栏内部元素的对齐，调整为合理数值：

doneItem.imageInsets = UIEdgeInsets(top: 0, left: 8, bottom: 0, right: 8)

可选扩展：自定义标题控件 #

如果默认标题的位置仍不符合需求，可以完全自定义titleView自主控制布局：

// 自定义标题标签
let titleLabel = UILabel()
titleLabel.text = R.string.localization.supportNavigationBarTittle()
titleLabel.font = .systemFont(ofSize: 17, weight: .semibold)
titleLabel.textColor = .white
titleLabel.textAlignment = .center
// 赋值给navItem的titleView
navItem.titleView = titleLabel

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