小设备下SplitViewController无法从MasterViewController跳转至DetailViewController求助

嘿，这个问题我之前适配老款iPhone的时候也踩过坑！核心原因是小屏设备上SplitViewController会自动进入「折叠模式」，此时默认只会显示MasterViewController，不像iPad的「展开模式」那样并排双视图。要实现点击cell跳转Detail，得用SplitVC自带的适配方法，而非手动push，这样能同时兼容两种设备模式。

第一步：确保SplitVC的基础配置正确 #

首先要保证你的SplitViewController视图结构是「导航控制器包裹Master + 导航控制器包裹Detail」，这样折叠模式下跳转后才有导航栏支持返回操作。在AppDelegate/SceneDelegate里初始化SplitVC的代码可以这么写：

// 初始化Master和Detail视图控制器
let masterVC = MasterViewController()
let detailVC = DetailViewController()

// 用导航控制器分别包裹，保证导航栏交互正常
let masterNav = UINavigationController(rootViewController: masterVC)
let detailNav = UINavigationController(rootViewController: detailVC)

// 创建SplitVC并设置视图控制器数组
let splitVC = UISplitViewController(style: .doubleColumn)
splitVC.viewControllers = [masterNav, detailNav]

// 让系统自动适配显示模式（折叠/展开）
splitVC.preferredDisplayMode = .automatic

第二步：在Master的cell点击事件中使用系统适配方法 #

别手动写navigationController?.pushViewController(...)，而是调用SplitVC的showDetailViewController(_:sender:)方法——这个方法会自动判断当前是折叠还是展开模式，做出对应的跳转逻辑：

override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    tableView.deselectRow(at: indexPath, animated: true)
    
    // 初始化目标DetailViewController，这里可以传递选中的数据
    let targetDetailVC = DetailViewController()
    targetDetailVC.selectedData = yourDataSource[indexPath.row] // 假设你有数据源需要传递
    
    // 关键：调用SplitVC的适配方法
    if let splitViewController = self.splitViewController {
        // 把Detail包裹在导航控制器里，保证折叠模式下有返回栏
        let detailNav = UINavigationController(rootViewController: targetDetailVC)
        splitViewController.showDetailViewController(detailNav, sender: self)
    }
}

为什么这么做？ #

• 在iPad展开模式下：这个方法会直接更新右侧的Detail视图，保持双栏显示的原生体验。
• 在小屏iPhone折叠模式下：这个方法会自动把DetailViewController push到Master的导航栈中，此时Detail的导航栏会自动出现返回按钮，用户可以轻松回到Master。

额外注意点 #

• 如果你的DetailViewController需要保留状态（比如不想每次点击都新建实例），可以先获取SplitVC中已有的Detail控制器，更新数据后再调用showDetailViewController。
• 可以通过splitViewController?.isCollapsed属性手动判断当前是否处于折叠模式，做一些自定义UI逻辑（比如隐藏/显示特定控件）。

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