隐藏UINavigationBar时保持UITableView的Y偏移量技术咨询

一、隐藏导航栏时被更新的核心属性 #

当你调用self.navigationController?.setNavigationBarHidden(true, animated: false)隐藏导航栏时，系统主要通过以下两组属性自动调整UITableView的布局：

• iOS 11及以上：contentInsetAdjustmentBehavior（属于UIScrollView的属性，UITableView继承自它），系统会根据导航栏的显示状态自动修改tableView的contentInset和contentOffset，让内容填充原本导航栏占据的空间。
• iOS 11以下：automaticallyAdjustsScrollViewInsets（属于UIViewController的属性），作用和上面类似，自动调整滚动视图的内边距。

本质上是系统修改了tableView的contentInset.top值，把原本导航栏的高度（44px）从内边距中移除，导致tableView内容顶到屏幕顶部。

二、实现保持Y偏移44px的方法 #

这里推荐两种优雅的实现方式，适配不同iOS版本：

方法1：禁用自动内边距调整，手动设置顶部内边距（推荐）

在你的UITableViewController的viewDidLoad方法中添加以下代码：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 禁用系统自动调整内边距
    if #available(iOS 11.0, *) {
        tableView.contentInsetAdjustmentBehavior = .never
    } else {
        automaticallyAdjustsScrollViewInsets = false
    }
    
    // 手动设置顶部内边距为44px，模拟导航栏的高度
    let topInset: CGFloat = 44
    tableView.contentInset = UIEdgeInsets(top: topInset, left: 0, bottom: 0, right: 0)
    // 同步滚动指示器的偏移，保持视觉一致
    tableView.scrollIndicatorInsets = tableView.contentInset
}

这种方法的好处是完全利用UIScrollView的原生内边距机制，不会破坏tableView的布局逻辑，滚动时的表现也更自然。

方法2：调整视图延伸范围，固定tableView位置

如果你更倾向于直接修改tableView的布局范围，可以设置控制器的edgesForExtendedLayout属性，让视图不延伸到导航栏区域，再手动调整tableView的frame：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 禁止视图延伸到导航栏所在的顶部区域
    edgesForExtendedLayout = .bottom
}

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    var frame = tableView.frame
    frame.origin.y = 44
    frame.size.height = view.bounds.height - 44
    tableView.frame = frame
}

不过这种方法需要处理布局更新的时机，不如第一种方法灵活。

补充说明 #

如果你的页面底部有TabBar，记得同时调整contentInset.bottom的值（通常是49px），避免内容被TabBar遮挡。

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