设置tableView顶部内边距后导航栏LargeTitle首次加载不显示

该问题由iOS系统LargeTitle自动适配逻辑与手动设置UITableView顶部内边距的操作冲突导致。系统默认会根据导航栏、状态栏高度自动调整UIScrollView（包含UITableView）的内边距，以适配LargeTitle的展开/折叠状态，手动修改top inset会打断页面初始渲染阶段的布局计算，最终导致LargeTitle首次加载时展示异常。

• 方案1：关闭系统自动调整逻辑后再手动设置内边距
  先禁用系统对scrollView的自动内边距调整，再设置自定义的top inset，Swift示例代码如下：

  if #available(iOS 11.0, *) {
      tableView.contentInsetAdjustmentBehavior = .never
  } else {
      automaticallyAdjustsScrollViewInsets = false
  }
  // 替换为实际需要的顶部内边距数值
  tableView.contentInset = UIEdgeInsets(top: 20, left: 0, bottom: 0, right: 0)
  

  同时确保LargeTitle的全局和页面级配置正确：

  // 全局开启LargeTitle
  navigationController?.navigationBar.prefersLargeTitles = true
  // 当前页面的LargeTitle显示规则，按需设置为.always/.automatic/.never
  navigationItem.largeTitleDisplayMode = .always
  

• 方案2：在系统布局完成后设置内边距
  不要在viewDidLoad生命周期方法中设置tableView的top inset，改到布局完成的回调中设置，避免和系统初始布局逻辑冲突：

  override func viewDidLoad() {
      super.viewDidLoad()
      // 其他初始化逻辑
      DispatchQueue.main.async {
          // 等主线程初始布局任务完成后再设置自定义内边距
          self.tableView.contentInset = UIEdgeInsets(top: 20, left: 0, bottom: 0, right: 0)
      }
  }
  

  也可以将内边距设置逻辑放到viewDidLayoutSubviews方法中，注意避免重复设置。

• 方案3：保留系统适配逻辑，叠加额外偏移量
  如果不需要修改系统默认的内边距适配规则，不要直接修改contentInset的top值，基于系统计算好的adjustedContentInset叠加自定义偏移量即可：

  // 自定义需要额外增加的顶部偏移量
  let extraTopOffset: CGFloat = 20
  
  override func scrollViewDidScroll(_ scrollView: UIScrollView) {
      let totalTopInset = scrollView.adjustedContentInset.top + extraTopOffset
      // 后续业务逻辑基于totalTopInset计算即可
  }
  

• 首次进入页面确认LargeTitle正常展开显示
• 向下滑动tableView，确认LargeTitle可以正常折叠为标准尺寸标题
• 滑动tableView回到顶部，确认LargeTitle可以正常展开，且tableView内容没有被导航栏遮挡

内容的提问来源于stack exchange，提问作者Катя Акулина