Swift开发：@AppStorage默认值未生效，如何设置初始值为true？

问题根源 #

1. @AppStorage的默认值特性：你写的@AppStorage("Music") private var music: Bool = true里的true只是内存层面的 fallback 值，不会自动写入UserDefaults的plist文件。只有用户主动切换开关修改music变量时，才会把值持久化到plist中。
2. UserDefaults的bool读取默认行为：如果直接调用UserDefaults.standard.bool(forKey: "Music")，当key不存在时会默认返回false，这是UserDefaults本身的设计特性，和@AppStorage的fallback值无关。
3. 初始化代码执行时机问题：你在根视图出现时执行的初始化代码，可能晚于@AppStorage变量的初始化，导致变量已经读取了UserDefaults的默认false，后续设置的值无法同步到已初始化的变量中。

正确解决方案 #

方案1：提前注册UserDefaults默认值（Apple推荐）

在App启动阶段注册所有偏好的默认值，这是最规范的做法。注册的默认值会作为UserDefaults的全局 fallback，既不会提前写入plist，又能保证所有读取该key的地方（包括@AppStorage和直接调用UserDefaults）都能拿到正确的默认值。

修改你的App结构体：

@main
struct YourApp: App {
    init() {
        // 注册应用偏好的默认值
        let defaultPreferences: [String: Any] = [
            "Music": true
        ]
        UserDefaults.standard.register(defaults: defaultPreferences)
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView() // 你的根视图
        }
    }
}

之后你的View代码保持不变即可：

@AppStorage("Music") private var music: Bool = true

方案2：主动写入默认值到plist

如果你需要把默认值提前写入plist文件，确保初始化代码在App启动时就执行，而不是等到根视图加载。

修改App结构体：

@main
struct YourApp: App {
    init() {
        let defaults = UserDefaults.standard
        // 检查key是否存在，不存在则写入默认值
        if defaults.object(forKey: "Music") == nil {
            defaults.set(true, forKey: "Music")
        }
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

View中的@AppStorage代码无需修改，启动后会自动读取已写入plist的true值。

内容的提问来源于stack exchange，提问作者Björn