SwiftUI中@Environment+@Binding异常：$myBool报错但_myBool.wrappedValue可用

我尝试通过自定义@EnvironmentKey在SwiftUI视图层级中传递@Binding值。在NestedView里，我这样组合使用@Environment和@Binding：

@Environment(\.featureEnabledBinding) @Binding var myBool: Bool

原本以为可以在Toggle里这样用：

Toggle(isOn: $myBool, label: { Text("Toggle") })

但编译器报错：

Cannot find '$myBool' in scope

而下面的写法却能正常运行：

Toggle(isOn: _myBool.wrappedValue, label: { Text("Toggle") })

这和我的预期不符，我原本的理解是：

• _myBool是包装器（类型为Binding<Bool>）
• $myBool是投影值（同样应该是Binding<Bool>）

环境配置代码 #

struct FeatureEnabledKey: EnvironmentKey {
    static let defaultValue: Binding<Bool> = .constant(false)
}

extension EnvironmentValues {
    var featureEnabledBinding: Binding<Bool> {
        get { self[FeatureEnabledKey.self] }
        set { self[FeatureEnabledKey.self] = newValue }
    }
}

最小可复现示例 #

struct ParentView: View {
    @State private var isFeatureEnabled = false

    var body: some View {
        NestedView()
            .environment(\.featureEnabledBinding, $isFeatureEnabled)
    }
}

struct NestedView: View {
    @Environment(\.featureEnabledBinding) @Binding var myBool: Bool

    var body: some View {
        VStack {
            // ❌ 报错：Cannot find '$myBool' in scope
            // Toggle(isOn: $myBool, label: { Text("Toggle") })

            // ✅ 正常工作
            Toggle("Working Toggle", isOn: _myBool.wrappedValue)
        }
    }
}

疑问 #

为什么$myBool在这里不可用？这是SwiftUI/编译器针对双重属性包装器（@Environment + @Binding）的已知bug，还是我的理解有误？（使用Xcode 16.3）

原因分析 #

问题核心是错误叠加了两个属性包装器：@Environment(\.featureEnabledBinding)本身返回的就是Binding<Bool>类型的值，不需要再额外添加@Binding包装器。

• 当你写@Environment(\.featureEnabledBinding) var myBool: Bool时，SwiftUI会自动将环境中的Binding<Bool>解包为其包装的Bool值，同时为你生成符合预期的投影值$myBool（类型为Binding<Bool>），这才是正确的用法。
• 叠加@Binding后，相当于把一个Binding<Bool>再用@Binding包装一次，此时_myBool的实际类型是Binding<Binding<Bool>>，而非你以为的Binding<Bool>。这种错误叠加会打乱编译器对属性包装器的处理逻辑：
  • myBool变成了内层的Binding<Bool>（即_myBool.wrappedValue）
  • 理论上$myBool应该是Binding<Binding<Bool>>的投影值，但编译器无法正确处理这种嵌套包装的情况，直接报错找不到$myBool。

正确写法 #

写法一：自动解包为Bool值 #

修改NestedView的属性声明，去掉多余的@Binding：

@Environment(\.featureEnabledBinding) private var myBool: Bool

此时即可正常使用$myBool：

Toggle(isOn: $myBool, label: { Text("Toggle") })

写法二：直接持有Binding类型 #

如果想直接保留Binding<Bool>类型的变量，可直接声明：

@Environment(\.featureEnabledBinding) private var myBoolBinding: Binding<Bool>

使用时直接传递该变量即可：

Toggle(isOn: myBoolBinding, label: { Text("Toggle") })

内容的提问来源于stack exchange，提问作者Wahab Khan Jadon