UISplitViewController主列（侧边栏）frame原点异常问题求助

问题背景 #

仅在iPad（iOS 16模拟器、Xcode 14.0.1，目标iOS 12）上，使用Double Column样式的UISplitViewController时，主列（侧边栏）原点为负值，出现布局偏移；Detail控制器包含UITableView/UITableViewController，或添加UISegmentedControl后问题更明显，Storyboard中模拟尺寸设为「Primary」时也可见。手动调整列宽、通过代码/Storyboard初始化SplitVC均无法解决。

核心原因 #

Double Column样式的UISplitViewController主列默认包含100pt的屏幕外缓冲区，若视图控制器未正确适配系统的safeAreaLayoutGuide，或布局约束未关联安全区域，会导致主列视图的frame被错误计算，出现原点偏移。

长期修复方案 #

以下方案均基于系统官方API实现，避免临时hack，保障跨版本兼容性：

1. 主列控制器强制关联Safe Area布局 #

在主列（Master）的ViewController中，确保所有子视图的约束绑定到safeAreaLayoutGuide，而非直接使用view的frame：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 适配导航栏（若有）
    if let navBar = navigationController?.navigationBar {
        navBar.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            navBar.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
            navBar.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor),
            navBar.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor)
        ])
    }
    
    // 若主列是UITableViewController，修正TableView约束
    if let tableView = view as? UITableView {
        tableView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            tableView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
            tableView.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor),
            tableView.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor),
            tableView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
        ])
    }
}

2. 正确配置UISplitViewController的列属性 #

初始化SplitVC时，通过官方API设置列宽范围和展示模式，避免系统自动布局异常：

let splitVC = UISplitViewController(style: .doubleColumn)

// 设置主列宽范围（根据需求调整）
splitVC.preferredPrimaryColumnWidth = 320
splitVC.minimumPrimaryColumnWidth = 280
splitVC.maximumPrimaryColumnWidth = 360

// 配置展示模式，让系统自动管理列的位置
splitVC.preferredDisplayMode = .automatic

// 关联主副控制器
splitVC.setViewController(masterVC, for: .primary)
splitVC.setViewController(detailVC, for: .secondary)

// 设置为根控制器
self.window?.rootViewController = splitVC
self.window?.makeKeyAndVisible()

3. 修复Detail控制器的布局（含SegmentedControl场景） #

若Detail控制器包含UISegmentedControl和UITableView，需确保所有控件的约束正确关联安全区域，避免布局冲突：

override func viewDidLoad() {
    super.viewDidLoad()
    
    let segmentedControl = UISegmentedControl(items: ["选项1", "选项2"])
    segmentedControl.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(segmentedControl)
    
    let tableView = UITableView()
    tableView.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(tableView)
    
    NSLayoutConstraint.activate([
        // SegmentedControl约束
        segmentedControl.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor, constant: 8),
        segmentedControl.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor, constant: 16),
        segmentedControl.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor, constant: -16),
        
        // TableView约束
        tableView.topAnchor.constraint(equalTo: segmentedControl.bottomAnchor, constant: 8),
        tableView.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor),
        tableView.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor),
        tableView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
    ])
}

4. Storyboard场景补充配置 #

若通过Storyboard创建SplitVC：

• 确保SplitViewController的Style设为Double Column，Display Mode设为Automatic
• 所有控件的约束均绑定到Safe Area Layout Guide，而非父视图的边缘

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