如何始终隐藏UISplitViewController的详情视图控制器

你可以通过UISplitViewController的原生API实现需求，完全不需要手动修改约束，既能保留紧凑尺寸类下的push/pop功能，又能满足大屏iPad的初始隐藏要求：

1. 初始仅加载主视图控制器 #

初始化UISplitViewController时，只传入主视图控制器，不设置详情VC：

let primaryVC = PrimaryViewController() // 你的主列表VC
let splitVC = UISplitViewController(style: .doubleColumn)
splitVC.viewControllers = [primaryVC]
// 可选：设置代理实现更精细的显示逻辑控制
splitVC.delegate = self

不管是大屏iPad全屏模式，还是小屏设备，初始状态都只会显示主VC，详情区域完全隐藏。

2. 选择内容后加载详情VC并触发滑入动画 #

当用户在主VC完成第一次选择后，调用showDetailViewController(_:sender:)方法加载详情VC：

// 主VC中选择事件的处理代码
func didSelectItem(_ item: YourDataModel) {
    let detailVC = DetailViewController()
    detailVC.data = item
    // 该方法自动适配尺寸类：大屏下滑入详情，小屏上push到导航栈
    splitViewController?.showDetailViewController(detailVC, sender: self)
}

这是UISplitViewController的原生方法，会根据当前尺寸类自动切换展示逻辑——紧凑尺寸类（如iPhone）下自动执行push操作，保留原生导航栈的pop功能；常规尺寸类（如iPad全屏）下则从右侧滑入详情VC。

3. 进阶：动态隐藏详情VC（可选） #

如果需要在后续操作中重新隐藏详情VC（比如用户回到主VC根目录），iOS 14及以上可直接调用隐藏API：

splitViewController?.hide(.secondary)

也可以重置viewControllers回到仅主VC的状态：

splitViewController?.viewControllers = [primaryVC]

关键注意事项 #

• 不要通过修改约束来隐藏详情VC，这会破坏UISplitViewController原生的尺寸类适配逻辑，导致紧凑模式下的push/pop功能失效。
• 始终使用UISplitViewController的原生API，这些方法已经帮你处理了所有尺寸类的适配逻辑。

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