iPad模态展示UISplitViewController双列模式主列宽度无法调整求助

核心原因 #

模态展示的DoubleColumn分栏视图，系统默认布局优先级会覆盖preferredPrimaryColumnWidth、preferredPrimaryColumnWidthFraction这类属性，需要用更直接的宽度约束来强制指定。

有效解决方案 #

使用primaryColumnWidthConstraints属性（iOS 14+可用）来精确控制主列宽度，搭配.tile分栏行为，具体代码示例：

// 创建DoubleColumn分栏视图
let splitVC = UISplitViewController(style: .doubleColumn)
// 设置分栏行为为平铺（确保双列同时显示）
splitVC.preferredSplitBehavior = .tile
// 强制设置主列固定宽度为300pt，也可结合最大/最小约束
splitVC.primaryColumnWidthConstraints = [.fixed(300)]
// 你也可以同时限制最大宽度，比如：
// splitVC.primaryColumnWidthConstraints = [.fixed(300), .maximum(400)]

// 设置主、详情视图控制器
splitVC.viewControllers = [你的主视图控制器, 你的详情视图控制器]

// 模态展示分栏视图
present(splitVC, animated: true)

额外注意事项 #

1. 确保直接模态展示UISplitViewController，不要将其嵌入到UINavigationController后再模态，否则宽度约束可能失效。
2. 如果在视图控制器生命周期后期调整宽度（比如viewDidAppear），需要调用splitVC.view.setNeedsLayout()触发重新布局：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    splitVC.primaryColumnWidthConstraints = [.fixed(350)]
    splitVC.view.setNeedsLayout()
}

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