iOS 11 Swift 4下iPhone X全屏ScrollView安全区域适配问题求助

我之前也踩过全面屏设备上ScrollView分页的坑，核心问题其实是安全区域（Safe Area）适配不到位，再加上iOS 11+系统对ScrollView的自动内边距调整干扰了布局，咱们一步步来修复：

1. 先理清问题根源 #

iPhone X及之后的全面屏设备，顶部有状态栏、底部有Home Indicator，这些属于"不安全区域"。你之前用self.view.frame计算contentSize，这个frame的高度包含了安全区域，但实际用户能正常交互的内容高度是safeAreaLayoutGuide的高度。这就导致两个问题：

• 每一页的高度计算偏大，滑动时系统会把多余高度当成可滑动区域，出现"单页多次分页"的情况
• iOS 11+默认会自动给ScrollView添加contentInset来避开安全区域，直接造成内容偏移

2. 具体修复步骤 #

（1）用安全区域尺寸计算contentSize #

把原来依赖self.view.frame的高度替换成安全区域高度，代码修改如下：

if #available(iOS 11.0, *) {
    let safeAreaHeight = self.view.safeAreaLayoutGuide.layoutFrame.size.height
    self.scrollView.contentSize = CGSize(width: self.view.frame.width, height: safeAreaHeight * 3)
} else {
    // 适配iOS 11以下设备，直接用view.frame高度
    self.scrollView.contentSize = CGSize(width: self.view.frame.width, height: self.view.frame.size.height * 3)
}

（2）关闭ScrollView的自动内边距调整 #

iOS 11+系统默认会帮ScrollView调整contentInset适配安全区域，这会打乱自定义布局，所以要手动关闭：

if #available(iOS 11.0, *) {
    self.scrollView.contentInsetAdjustmentBehavior = .never
}

（3）确保子视图控制器的view尺寸精准 #

添加子VC时，要把它们的view frame严格对应到安全区域的分页高度，示例代码：

// 假设添加3个子VC
for index in 0..<3 {
    let childVC = YourChildViewController()
    addChild(childVC)
    if #available(iOS 11.0, *) {
        let safeHeight = self.view.safeAreaLayoutGuide.layoutFrame.size.height
        childVC.view.frame = CGRect(x: 0, y: safeHeight * CGFloat(index), width: self.view.frame.width, height: safeHeight)
    } else {
        let viewHeight = self.view.frame.height
        childVC.view.frame = CGRect(x: 0, y: viewHeight * CGFloat(index), width: self.view.frame.width, height: viewHeight)
    }
    self.scrollView.addSubview(childVC.view)
    childVC.didMove(toParent: self)
}

（4）确认基础分页设置 #

别漏了开启ScrollView的核心分页功能：

self.scrollView.isPagingEnabled = true
self.scrollView.showsVerticalScrollIndicator = false // 可选，去掉滚动指示器更美观

3. 额外注意事项 #

• 如果子VC内部需要适配安全区域，记得在子VC里用safeAreaLayoutGuide约束内部控件，而非直接绑定view边缘
• 尽量用Auto Layout约束ScrollView，比如把ScrollView的top、leading、trailing、bottom都绑定到父视图的safeAreaLayoutGuide，从根源避免尺寸计算错误

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