SwiftUI iOS18中DragGesture触发含@AppStorage视图重复初始化问题

问题现象 #

• 在iOS 18的SwiftUI环境中，拖动屏幕左侧的SideMenuView时，所有包含@AppStorage的视图及其子视图会重复初始化，直接引发动画卡顿。
• 关键细节：DragGesture仅控制SideMenuView的左右位移，未修改任何@AppStorage绑定的UserDefaults变量；删除视图中的@AppStorage属性后问题完全消失；即便仅声明未使用的虚拟@AppStorage变量，问题依然会出现。

问题分析 #

iOS 18的SwiftUI框架在处理DragGesture触发的视图层级更新时，可能存在@AppStorage依赖追踪的逻辑偏差：即使绑定的存储值未发生变化，系统仍错误地将标记了@AppStorage的视图判定为需要重新初始化。@AppStorage作为绑定UserDefaults的属性包装器，其内部的依赖监听机制在特定交互场景下出现了误触发。

解决方案 #

1. 将@AppStorage封装到ObservableObject中 #

把@AppStorage属性移至单独的ObservableObject子类，通过@StateObject在视图中引用，让SwiftUI更精准地追踪依赖变化，避免视图因不必要的@AppStorage触发而重复初始化。

class AppSettings: ObservableObject {
    @AppStorage("theme") var theme = "light"
    // 其他@AppStorage属性
}

struct ContentView: View {
    @StateObject private var settings = AppSettings()

    var body: some View {
        Text("当前主题：\(settings.theme)")
        // 其他视图内容
    }
}

2. 自定义UserDefaults包装器替代@AppStorage #

手动实现UserDefaults的读写逻辑，结合@State或ObservableObject管理状态，减少系统自动追踪带来的误判问题。

struct CustomStorage<T: Codable> {
    private let key: String
    private let defaultValue: T

    init(key: String, defaultValue: T) {
        self.key = key
        self.defaultValue = defaultValue
    }

    var wrappedValue: T {
        get {
            guard let data = UserDefaults.standard.data(forKey: key),
                  let value = try? JSONDecoder().decode(T.self, from: data) else {
                return defaultValue
            }
            return value
        }
        set {
            guard let data = try? JSONEncoder().encode(newValue) else { return }
            UserDefaults.standard.set(data, forKey: key)
        }
    }
}

// 视图中使用
struct SomeView: View {
    @State private var theme = CustomStorage(key: "theme", defaultValue: "light").wrappedValue

    var body: some View {
        Text("当前主题：\(theme)")
    }
}

3. 隔离含@AppStorage的视图层级 #

将包含@AppStorage的视图封装为独立子视图，添加.equatable()修饰符，仅当绑定的存储值真正变化时才触发重绘。

struct SettingsView: View, Equatable {
    static func == (lhs: SettingsView, rhs: SettingsView) -> Bool {
        // 仅当存储属性变化时返回false，触发重绘
        lhs.theme == rhs.theme
    }

    @AppStorage("theme") private var theme = "light"

    var body: some View {
        Text("当前主题：\(theme)")
    }
}

// 父视图中调用
struct ParentView: View {
    var body: some View {
        SettingsView()
            .equatable()
    }
}

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