SwiftUI环境变量报错：无法赋值，‘hits’为只读属性

我尝试按照苹果官方文档设置自定义SwiftUI环境变量，代码如下：

App.swift 代码 #

@main
struct MyApp: App {
    let persistenceController = PersistenceController.shared

    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.managedObjectContext, persistenceController.container.viewContext)
                .environment(\.hits, [])
        }
    }
}

private struct HitsArrayKey: EnvironmentKey {
    static let defaultValue: [Hit] = []
}

extension EnvironmentValues {
    var hits : [Hit] {
        get { self[HitsArrayKey.self] }
        set { self[HitsArrayKey.self] = newValue }
    }
}

extension View {
    func myCustomValue(_ myCustomValue: [Hit]) -> some View {
        environment(\.hits, myCustomValue)
    }
}

但在视图中尝试修改该变量时，出现错误：

Cannot assign to property: 'hits' is a get-only property

视图代码片段：

struct ContentView: View {
    @Environment(\.managedObjectContext) private var viewContext
    @Environment(\.hits) private var hits: [Hit]
    
    var body: some View {
        Button(action: addItem) {
            Label("GET", systemImage: "plus")
            hits = []   // 报错：Cannot assign to property: 'hits' is a get-only property 
        }
        ...
    }
}

SwiftUI的@Environment属性包装器默认是只读的，即便你在EnvironmentValues中定义了setter，子视图也无法直接修改环境变量——这是因为环境变量遵循单向数据流设计，子视图仅能读取环境值，修改操作必须由持有状态的上游视图完成。以下是两种可行的解决方案：

方案1：用ObservableObject管理可变状态（推荐） #

将hits包装在可观察对象中，既能实现跨视图的状态共享，又能直接修改并自动触发UI刷新：

1. 创建可观察对象类：

class HitsStore: ObservableObject {
    @Published var hits: [Hit] = []
}

2. 在App中注入环境对象：
   修改MyApp代码，将HitsStore实例传入环境：

@main
struct MyApp: App {
    let persistenceController = PersistenceController.shared
    let hitsStore = HitsStore() // 创建状态管理实例

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.managedObjectContext, persistenceController.container.viewContext)
                .environmentObject(hitsStore) // 注入环境
        }
    }
}

3. 在视图中使用并修改：

struct ContentView: View {
    @Environment(\.managedObjectContext) private var viewContext
    @EnvironmentObject private var hitsStore: HitsStore // 获取环境对象
    
    var body: some View {
        Button(action: {
            hitsStore.hits = [] // 直接修改状态
        }) {
            Label("GET", systemImage: "plus")
        }
        ...
    }
}

方案2：用Binding结合环境变量（适合简单场景） #

如果坚持使用自定义环境键，可以通过Binding传递可修改的状态：

1. 修改环境键类型为Binding：

private struct HitsBindingKey: EnvironmentKey {
    static let defaultValue: Binding<[Hit]> = .constant([])
}

extension EnvironmentValues {
    var hits: Binding<[Hit]> {
        get { self[HitsBindingKey.self] }
        set { self[HitsBindingKey.self] = newValue }
    }
}

extension View {
    func hits(_ value: Binding<[Hit]>) -> some View {
        environment(\.hits, value)
    }
}

2. 在父视图中定义状态并传递绑定：

@main
struct MyApp: App {
    let persistenceController = PersistenceController.shared
    @State private var hits: [Hit] = [] // 上游持有状态

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.managedObjectContext, persistenceController.container.viewContext)
                .hits($hits) // 传递绑定
        }
    }
}

3. 在ContentView中修改：

struct ContentView: View {
    @Environment(\.managedObjectContext) private var viewContext
    @Environment(\.hits) private var hits: Binding<[Hit]> // 接收Binding
    
    var body: some View {
        Button(action: {
            hits.wrappedValue = [] // 通过wrappedValue修改状态
        }) {
            Label("GET", systemImage: "plus")
        }
        ...
    }
}

原代码报错原因 #

@Environment(\.hits)本质是读取环境中的不可变值，即便EnvironmentValues中定义了setter，子视图直接赋值的操作也违反了SwiftUI单向数据流的设计规则——环境变量的修改权限仅属于持有原始状态的上游视图，因此编译器会判定hits为只读属性。

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