Swift中如何检测系统明暗模式切换？自定义样式场景的处理方案

你的实现思路问题点 #

直接重写视图控制器的userInterfaceStyle是错误做法——这个属性本质是只读属性，系统通过它返回当前生效的样式；强行重写会切断视图控制器与系统样式的联动逻辑，导致系统切换明暗时无法触发traitCollectionDidChange。正确的自定义样式方式应该使用overrideUserInterfaceStyle属性，这是Apple提供的用于设置自定义样式优先级的API：

• 设置为.unspecified：视图控制器跟随系统/父视图控制器的样式
• 设置为.light/.dark：强制视图控制器使用对应样式

解决方法 #

1. 修正自定义样式逻辑 #

添加一个存储用户选择模式的属性（比如preferredAppearanceMode，可选值：system/light/dark），根据这个属性动态设置overrideUserInterfaceStyle：

enum AppearanceMode {
    case system, light, dark
}

class YourViewController: UIViewController {
    var preferredAppearanceMode: AppearanceMode = .system {
        didSet {
            switch preferredAppearanceMode {
            case .system:
                overrideUserInterfaceStyle = .unspecified
            case .light:
                overrideUserInterfaceStyle = .light
            case .dark:
                overrideUserInterfaceStyle = .dark
            }
        }
    }
    
    // ... 其他业务代码
}

这样设置后：

• 当用户选择「系统」模式时，视图控制器会跟随系统样式变化，系统切换明暗时仍会触发traitCollectionDidChange
• 当用户选择「浅色/深色」时，视图控制器强制使用对应样式，不受系统变化影响

2. 监听系统样式全局变化 #

如果需要全局监听系统明暗切换（比如同步多个页面的样式），可以通过以下两种方式：

方式一：监听屏幕Trait变化通知

在需要监听的位置（比如基类VC、AppDelegate）添加观察者：

NotificationCenter.default.addObserver(
    self,
    selector: #selector(onScreenTraitChanged(_:)),
    name: UIScreen.traitCollectionDidChangeNotification,
    object: UIScreen.main
)

@objc func onScreenTraitChanged(_ notification: Notification) {
    guard let screen = notification.object as? UIScreen else { return }
    let currentStyle = screen.traitCollection.userInterfaceStyle
    // 处理系统样式变化逻辑，比如同步全局主题
}

方式二：在AppDelegate中处理全局Trait变化

实现UIApplicationDelegate的对应方法：

func application(_ application: UIApplication, traitCollectionDidChange previousTraitCollection: UITraitCollection?) {
    let currentStyle = application.traitCollection.userInterfaceStyle
    // 处理全局样式变化逻辑
}

3. 正确使用traitCollectionDidChange #

修正样式设置逻辑后，在视图控制器中正常重写traitCollectionDidChange即可处理样式变化：

override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {
    super.traitCollectionDidChange(previousTraitCollection)
    guard previousTraitCollection?.userInterfaceStyle != traitCollection.userInterfaceStyle else { return }
    // 处理当前VC的样式更新，比如更换主题色、适配图片等
}

额外优化建议 #

• 将样式管理逻辑封装为单例类（比如AppearanceManager），统一处理用户偏好存储、全局样式同步，避免在多个VC中重复代码
• 使用UserDefaults持久化用户选择的模式，应用启动时读取并设置全局的overrideUserInterfaceStyle（可设置在UIWindow或UINavigationController上，让所有子VC默认跟随）
• 对于自定义View，直接重写traitCollectionDidChange方法实现自身样式适配，无需依赖VC传递样式变化

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