SwiftUI应用默认白色窗口背景的设置位置及修改方法咨询

阿华AIGC实验室

2026-4-2

嘿，这个问题问得特别到位——很多刚上手SwiftUI的开发者都会好奇这块默认白色背景到底藏在层级的哪个角落，我来给你把来龙去脉讲清楚：

一、默认白色背景的来源位置

其实这块白色背景并不是SwiftUI视图层级里的某个子视图，而是来自底层AppKit（macOS）/UIKit（iOS）的窗口本身！

SwiftUI本质是基于这两个原生框架封装的：

在iOS/iPadOS上，你的ContentView是被挂载到UIHostingController里，而这个控制器又依附于系统的UIWindow——UIWindow的backgroundColor属性默认就是白色，当你的ContentView没有铺满整个窗口时，窗口本身的背景就会从空白区域透出来。
在macOS上，对应的是NSWindow的backgroundColor属性，同样默认白色，NSHostingController把你的ContentView作为子视图挂载后，未被内容覆盖的区域就会显示窗口的默认背景。

简单说：你看到的白色，是窗口的“底色”，不是SwiftUI给你加的额外视图背景。

二、直接修改默认窗口背景的方法（不用铺满内容）

既然知道了根源在窗口本身，那我们直接修改窗口的背景色就行，不用强制让ContentView撑满整个窗口。下面分平台给你具体代码示例：

iOS/iPadOS 实现方式

方式1：通过AppDelegate修改（兼容全版本）

@main
struct YourApp: App {
    // 关联自定义AppDelegate
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 获取应用的主窗口，修改背景色
        if let mainWindow = application.windows.first {
            mainWindow.backgroundColor = .systemTeal // 替换成你要的颜色
        }
        return true
    }
}

方式2：用Scene修饰器（iOS 16+ 简化版）

如果你的App只需要支持iOS 16及以上，直接在WindowGroup上用backgroundStyle修饰器就行：

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .backgroundStyle(Color.systemTeal) // 直接设置窗口背景色
    }
}

macOS 实现方式

方式1：通过AppDelegate修改（兼容全版本）

@main
struct YourApp: App {
    @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

class AppDelegate: NSObject, NSApplicationDelegate {
    func applicationDidFinishLaunching(_ aNotification: Notification) {
        // 获取主窗口并修改背景色
        if let mainWindow = NSApplication.shared.windows.first {
            mainWindow.backgroundColor = NSColor.systemTeal // 替换成目标颜色
        }
    }
}

方式2：用Scene修饰器（macOS 13+ 简化版）

同样，macOS 13+可以直接用修饰器快速修改：

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .backgroundStyle(Color.systemTeal)
    }
}