Swift中如何去除小屏设备safeArea显示实现背景全屏

数据老陈

2026-10-2

问题修复方案

根因定位

当前黑边问题核心是`detailsView`仅配置了居中约束，没有绑定父视图的尺寸，无法铺满整个屏幕，露出了底层ViewController的默认黑色背景。

修复步骤

替换ViewController中的约束配置逻辑
禁用自动布局转换，将detailsView的四边直接绑定到父视图的边缘，不要绑定安全区的居中锚点：

private func setupLayout() { 
    view.addSubview(detailsView)
    // 必须添加该行，禁用自动转换Autoresizing掩码为约束
    detailsView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
        detailsView.topAnchor.constraint(equalTo: view.topAnchor),
        detailsView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        detailsView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        detailsView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
    ])
}

如果需要detailsView内部的交互内容避开刘海、底部安全条，只需要将detailsView内部的子控件绑定到safeAreaLayoutGuide即可，外层容器不要绑定安全区，否则会出现上下黑边。

优化SceneDelegate的window初始化逻辑
使用系统提供的windowScene构造方法，不需要手动计算bounds，避免尺寸计算异常：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }
    // 替换为该构造方法，系统自动适配正确的屏幕尺寸
    self.window = UIWindow(windowScene: windowScene)
    self.window?.rootViewController = DetailsViewController()
    self.window?.makeKeyAndVisible()
}