如何通过Swift代码消除UINavigationController导航栏上方多余空白

问题根源 #

导航栏上方的空白是因为视图未正确适配安全区域，再结合开启了prefersLargeTitles的布局特性，以及跳转时的导航控制器嵌套问题共同导致。

具体修复步骤 #

1. 修正TableView顶部约束

在HomeScreen的configureTableView方法中，将TableView的顶部约束从视图顶部改为安全区域顶部，让布局自动避开状态栏和导航栏：

NSLayoutConstraint.activate([
    tableView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor), // 替换原view.topAnchor
    tableView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
    tableView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
    tableView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
])

2. 移除重复的导航控制器嵌套

HomeScreen本身已处于UINavigationController栈中，跳转CreateScreen时无需再包裹新的导航控制器，否则会引发双层导航栏或布局偏移：

@objc func addWord() {
    let vc = CreateScreen()
    navigationController?.pushViewController(vc, animated: true)
}

3. 适配Large Title导航栏外观（可选）

若仍存在布局异常，可在MainTabBarViewController中统一配置导航栏的滚动边缘外观，确保Large Title布局正常：

// 创建每个导航控制器后添加该配置
let appearance = UINavigationBarAppearance()
appearance.backgroundColor = .white
appearance.titleTextAttributes = [NSAttributedString.Key.foregroundColor: UIColor.systemBlue]
appearance.largeTitleTextAttributes = [NSAttributedString.Key.foregroundColor: UIColor.systemBlue]

homeVC.navigationBar.standardAppearance = appearance
homeVC.navigationBar.scrollEdgeAppearance = appearance
homeVC.navigationBar.compactAppearance = appearance

额外检查项 #

确认视图控制器的边缘扩展布局设置为默认值，避免手动修改导致的布局偏移：

// 在HomeScreen的configureVC方法中添加
edgesForExtendedLayout = .all

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