Xcode 14中Storyboard的Segue Push强制变为Modal问题求助

核心原因 #

Push 类型的 Segue 仅适用于 UINavigationController 管理的视图控制器栈。如果你的初始视图控制器没有嵌入到 UINavigationController 中，即使选择 Push 类型的 Segue，系统也会自动 fallback 为 Modal 样式，这就是你看到顶部间隙（Modal 默认的 sheet 或 page sheet 样式导致）的原因。

具体解决步骤 #

1. 为初始视图控制器嵌入 UINavigationController #

• 打开 Storyboard，选中你的根视图控制器（第一个ViewController）
• 点击顶部菜单栏的 Editor → Embed In → Navigation Controller
• 此时你的根控制器会被包裹在 NavigationController 中，NavigationController 会自动成为新的初始视图控制器

2. 重新配置 Segue 为 Push 类型 #

• 若之前已创建 Segue，先删除原有 Segue
• 按住 Ctrl 键从源控制器拖拽到目标控制器，在弹出菜单中选择 Show (Push)
• 选中新创建的 Segue，在右侧属性面板（Attributes Inspector）确认：
  • Segue 类型为 Show（对应 Push 行为）
  • Presentation 选项设置为 Automatic（在 NavigationController 栈中会自动触发 Push 逻辑）

3. 清除顶部间隙残留（若有） #

如果目标控制器仍存在顶部间隙，检查以下设置：

• 选中目标ViewController的View，在属性面板中确认 Safe Area Layout Guides 已勾选（或根据布局需求调整约束）
• 若不需要显示导航栏，可在源控制器的跳转方法中添加代码隐藏：

override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
    if segue.identifier == "你的Segue标识符" {
        let destinationVC = segue.destination
        destinationVC.navigationController?.isNavigationBarHidden = true
    }
}

也可以直接在Storyboard中选中NavigationController，取消勾选属性面板里的 Shows Navigation Bar

验证效果 #

运行项目触发Segue后，目标控制器会从右侧滑入（Push默认动画），且全屏展示，不会出现Modal样式的顶部间隙。

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