Swift 5、Xcode 15中如何阻止TableView滚动至状态栏下方

核心原因 #

问题本质是UIViewController的扩展布局属性导致TableView被导航栏/状态栏的延伸区域覆盖，你手动调整contentInset会让内容额外下移，因为系统已经自动为TableView添加了适配导航栏的顶部偏移量。

具体解决方案 #

方案1：修改ViewController的布局属性（推荐） #

在承载TableView的ViewController中，通过代码或可视化界面关闭视图延伸：

• 代码实现：

// 禁止视图向任何导航栏/标签栏延伸
self.edgesForExtendedLayout = []
// 也可仅禁止顶部延伸：self.edgesForExtendedLayout = .bottom

• Storyboard/XIB操作：
  选中目标ViewController，在右侧属性面板的Extend Edges区域，取消勾选Under Top Bars选项。

方案2：调整TableView的自动布局约束 #

确保TableView的顶部约束对齐到安全区域顶部（Safe Area.top），而非直接对齐到父视图的顶部。这样系统会自动避开状态栏和导航栏的区域。

方案3：修正contentInset的设置（代码兜底） #

系统默认会根据导航栏高度自动调整TableView的contentInset，你之前手动添加20pt属于重复偏移。可通过以下代码重置：

// 恢复系统自动适配逻辑
tableView.contentInsetAdjustmentBehavior = .automatic
// 若需完全手动控制，可设置为：tableView.contentInsetAdjustmentBehavior = .never

补充说明 #

如果你的NavigationBar设置为透明样式，建议同时结合方案1和方案2，确保TableView的内容完全处于安全区域内，不会被状态栏或导航栏遮挡。

内容的提问来源于stack exchange，提问作者S. Gissel