通过segue模态弹出的视图背景图片无法铺满全屏如何解决

对应效果参考 #

实际异常效果 #

预期目标效果 #

#

修复步骤 #

1. 修正模态弹出样式 #

iOS 13及以上系统默认模态弹出样式为卡片式pageSheet，本身就不会铺满全屏，这是该问题的最高概率诱因。

• Storyboard Segue配置：选中对应Segue，在属性检查器中将Presentation属性修改为Full Screen
• 代码弹出配置：弹出前设置目标控制器的模态样式

let targetVC = YourViewController()
targetVC.modalPresentationStyle = .fullScreen
present(targetVC, animated: true)

2. 调整背景视图约束 #

若已经设置全屏弹出仍有留白，说明背景视图的约束绑定到了安全区而非父视图边缘：

• Storyboard操作：选中背景图的四条边约束，取消Relative to Safe Area、Relative to Margin勾选，约束绑定到Superview，边距常量统一设为0
• 代码操作：直接绑定父视图边缘锚点，不要使用安全区锚点

backgroundView.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    backgroundView.topAnchor.constraint(equalTo: view.topAnchor),
    backgroundView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
    backgroundView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
    backgroundView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
])

3. 修正图片视图属性 #

确认承载背景图的UIImageView配置正确：

// 按比例撑满整个视图
backgroundImageView.contentMode = .scaleAspectFill
// 裁剪超出视图范围的内容
backgroundImageView.clipsToBounds = true

4. 关闭自动边距偏移 #

如果以上操作都无效，关闭父视图的安全区自动边距适配：

view.insetsLayoutMarginsFromSafeArea = false
view.layoutMargins = .zero

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