设置UINavigationBar背景图时状态栏未被覆盖问题求助

这是iOS开发里很常见的导航栏适配问题，你遇到的状态栏始终白色，核心原因是默认UINavigationBar的isTranslucent属性为true，此时导航栏会和状态栏分开渲染，背景图自然不会延伸到状态栏区域。下面给你两种针对性的解决方案：

方案1：兼容iOS 13及更早版本的基础写法 #

// 关键操作：关闭导航栏半透明，让它占据包括状态栏在内的整个顶部区域
self.navigationController?.navigationBar.isTranslucent = false

// 保留你原本的背景图设置逻辑
if let navBgImage = UIImage(named:"bg_nav")?.resizableImage(withCapInsets: UIEdgeInsets.zero, resizingMode: .stretch) {
    self.navigationController?.navigationBar.setBackgroundImage(navBgImage, for: .default)
    // 可选：移除导航栏底部的阴影线，让背景图衔接更自然
    self.navigationController?.navigationBar.shadowImage = UIImage()
}

// 重写状态栏样式，让文字颜色和你的背景图适配（比如深色背景用lightContent）
override var preferredStatusBarStyle: UIStatusBarStyle {
    return .lightContent
}

方案2：iOS 13+推荐的Appearance写法（更规范） #

iOS 13之后苹果引入了UINavigationBarAppearance，能更精准控制导航栏的各种状态外观，推荐用这种方式：

if #available(iOS 13.0, *) {
    let navAppearance = UINavigationBarAppearance()
    
    // 设置导航栏背景图
    if let navBgImage = UIImage(named:"bg_nav")?.resizableImage(withCapInsets: UIEdgeInsets.zero, resizingMode: .stretch) {
        navAppearance.backgroundImage = navBgImage
    }
    
    // 关闭半透明效果（必须设置，否则背景图还是无法延伸到状态栏）
    navAppearance.backgroundEffect = nil
    // 可选：移除导航栏底部阴影
    navAppearance.shadowColor = nil
    
    // 将配置好的外观应用到导航栏的所有状态
    self.navigationController?.navigationBar.standardAppearance = navAppearance
    self.navigationController?.navigationBar.scrollEdgeAppearance = navAppearance
    self.navigationController?.navigationBar.compactAppearance = navAppearance
} else {
    // iOS 13之前的兼容逻辑，和方案1一致
    self.navigationController?.navigationBar.isTranslucent = false
    if let navBgImage = UIImage(named:"bg_nav")?.resizableImage(withCapInsets: UIEdgeInsets.zero, resizingMode: .stretch) {
        self.navigationController?.navigationBar.setBackgroundImage(navBgImage, for: .default)
        self.navigationController?.navigationBar.shadowImage = UIImage()
    }
}

// 同样需要适配状态栏文字颜色
override var preferredStatusBarStyle: UIStatusBarStyle {
    return .lightContent
}

额外提醒 #

• 确保你的bg_nav图片尺寸足够覆盖顶部区域（iPhone全系列的顶部高度从44pt+20pt到59pt+47pt不等），resizableImage的.stretch模式可以让图片自适应拉伸填充。
• 如果是全局导航栏配置，建议把代码放到导航控制器的初始化方法，或者AppDelegate/SceneDelegate中统一设置。

内容的提问来源于stack exchange，提问作者a.masri