iOS跨Storyboard配置Show(Push) segue跳转却显示为模态弹窗的问题

跳转变成弹窗的核心原因 #

• Show (e.g. push)类型的跳转，本质是依赖当前页面所在的UINavigationController导航栈执行压栈操作。如果你的LoginViewController没有被导航控制器包裹，系统找不到可用于push的容器，会自动把这个segue降级为模态弹出。
• iOS 13及以上系统中，模态弹出的默认展示样式是pageSheet，也就是带圆角、背景半透明的半屏弹窗效果。跨storyboard创建的Show segue不会自动修改这个默认样式，最终就会呈现你看到的弹窗状态，而非普通整页跳转。

可落地的修正方式 #

方案1：匹配Show segue的运行条件（最符合原设置的逻辑） #

• 打开LoginVC对应的storyboard，选中LoginViewController，在Xcode顶部菜单栏依次选 Editor > Embed In > Navigation Controller，将LoginVC包裹在导航控制器中。
• 确认跨storyboard的segue类型确实为Show，此时系统能找到可用的导航栈，segue不会被降级，会正常执行push跳转，不会再出现弹窗。

方案2：无导航栈场景下手动调整展示样式 #

如果你的LoginVC本身不需要导航控制器，不想额外嵌套导航容器，可以直接修改segue的展示属性：

• 点击storyboard上你创建的那条跨storyboard的segue，在右侧属性检查器找到Presentation选项，将默认的Automatic改为Full Screen。
• 此时哪怕segue因为没有导航栈被降级为模态弹出，也会以全屏形式展示，和普通跳转效果一致。如果需要返回，可以在HomeScreen页面通过代码调用dismiss(animated: true)实现返回逻辑。

方案3：跳过跨storyboard的segue，手动实例化目标VC（跨storyboard场景更可控） #

跨storyboard的segue经常会出现样式匹配异常的问题，可以直接把原来按钮触发的segue逻辑替换成手动加载代码，完全自主控制跳转效果：

1. 先在HomeScreen所属的storyboard中，给HomeScreen设置好对应的Storyboard ID。
2. 将原来ProceedTapped方法的代码替换为：

@objc private func ProceedTapped(){
    // 加载HomeVC所在的storyboard，替换成你实际的storyboard文件名
    let homeStoryboard = UIStoryboard(name: "Home", bundle: nil)
    // 实例化目标页面，替换成你设置的Storyboard ID
    guard let homeVC = homeStoryboard.instantiateViewController(withIdentifier: "HomeScreen") as? HomeScreen else { return }
    // 全屏模态展示，避免弹窗样式
    homeVC.modalPresentationStyle = .fullScreen
    present(homeVC, animated: true)
}

• 如果需要push形式的跳转，只需要确保当前LoginVC在导航栈中，把present的代码换成navigationController?.pushViewController(homeVC, animated: true)即可。

内容的提问来源于stack exchange，提问作者Sem de Bakker