SwiftUI应用退至后台时ColorScheme无故切换问题咨询

我有一个基础SwiftUI项目，通过环境变量ColorScheme读取系统配色模式。发现应用处于浅色模式时，退到后台后，ColorScheme会在深色和浅色之间来回切换，哪怕我根本没修改系统配色设置。

代码示例 #

struct ContentView: View {
    @SwiftUI.Environment(\.colorScheme) var colorScheme

    var body: some View {
        VStack {
            let _ = Self._printChanges()
            let _ = print("====== colorscheme \(colorScheme)")
            Image(systemName: "globe")
                .imageScale(.large)
                .foregroundStyle(.tint)
            Text("Hello, world!")
        }
        .padding()
    }
}

后台时的打印日志 #

ContentView: _colorScheme changed.
====== colorscheme dark
ContentView: _colorScheme changed.
====== colorscheme light

这是Bug还是设计如此？有没有办法阻止这种无意义的切换？

原因分析 #

这不是Bug，是iOS/iPadOS的设计行为。应用退到后台时，系统会临时切换配色模式来处理后台快照生成等逻辑，完成后会自动恢复原模式，只是这个过程会触发colorScheme的变更通知。

解决方法 #

通过监听应用生命周期，结合本地状态过滤掉后台期间的临时切换即可：

方案1：单个视图内处理

import SwiftUI
import UIKit

struct ContentView: View {
    @Environment(\.colorScheme) var systemColorScheme
    @State private var currentColorScheme: ColorScheme = .light
    @State private var isAppActive = true
    
    var body: some View {
        VStack {
            let _ = print("====== current colorscheme \(currentColorScheme)")
            Image(systemName: "globe")
                .imageScale(.large)
                .foregroundStyle(.tint)
            Text("Hello, world!")
        }
        .padding()
        .onAppear {
            currentColorScheme = systemColorScheme
        }
        .onChange(of: systemColorScheme) { newValue in
            // 仅在应用活跃时更新有效配色
            if isAppActive {
                currentColorScheme = newValue
            }
        }
        .onReceive(NotificationCenter.default.publisher(for: UIApplication.didBecomeActiveNotification)) { _ in
            isAppActive = true
            // 回到前台时强制同步系统配色
            currentColorScheme = systemColorScheme
        }
        .onReceive(NotificationCenter.default.publisher(for: UIApplication.willResignActiveNotification)) { _ in
            isAppActive = false
        }
    }
}

之后视图内统一使用currentColorScheme，不再直接依赖环境变量的systemColorScheme。

方案2：全局封装（推荐）

如果多个视图都需要用到，可以自定义环境键，在App层面统一处理：

// 自定义环境键
struct ActiveColorSchemeKey: EnvironmentKey {
    static var defaultValue: ColorScheme = .light
}

extension EnvironmentValues {
    var activeColorScheme: ColorScheme {
        get { self[ActiveColorSchemeKey.self] }
        set { self[ActiveColorSchemeKey.self] = newValue }
    }
}

// App入口监听生命周期
@main
struct MyApp: App {
    @Environment(\.colorScheme) var systemColorScheme
    @State private var activeColorScheme: ColorScheme = .light
    @State private var isAppActive = true
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.activeColorScheme, activeColorScheme)
                .onAppear {
                    activeColorScheme = systemColorScheme
                }
                .onChange(of: systemColorScheme) { newValue in
                    if isAppActive {
                        activeColorScheme = newValue
                    }
                }
                .onReceive(NotificationCenter.default.publisher(for: UIApplication.didBecomeActiveNotification)) { _ in
                    isAppActive = true
                    activeColorScheme = systemColorScheme
                }
                .onReceive(NotificationCenter.default.publisher(for: UIApplication.willResignActiveNotification)) { _ in
                    isAppActive = false
                }
        }
    }
}

// 视图中使用全局配色
struct ContentView: View {
    @Environment(\.activeColorScheme) var currentColorScheme
    
    var body: some View {
        VStack {
            let _ = print("====== current colorscheme \(currentColorScheme)")
            Image(systemName: "globe")
                .imageScale(.large)
                .foregroundStyle(.tint)
            Text("Hello, world!")
        }
        .padding()
    }
}

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