SwiftUI #Preview宏结合Observation框架预览失效问题

环境信息 #

• Xcode Version 15.0 (15A240d)
• iOS 17
• MacBook Pro 14英寸2021款（M1 Pro芯片）

问题概述 #

用@Observable定义的Banana类，搭配旧版PreviewProvider的预览代码可正常运行，但改用#Preview宏后出现两个问题：

1. 编译器警告：Result of call to 'environment' is unused
2. 预览崩溃，错误日志显示init(_:traits:body:)存在歧义调用

Banana类定义：

@Observable class Banana {
    var ripe: String = "sort of"
}

解决方案 #

方案1：显式返回View实例 #

在#Preview宏的闭包中，将链式调用的View赋值给变量并显式返回，避免编译器的歧义推断：

#Preview {
    let previewView = ContentView()
        .environment(Banana())
    return previewView
}

方案2：使用环境键消除重载歧义 #

为Banana类定义专属环境键，明确注入的环境变量类型，彻底解决重载调用的歧义问题：

1. 先定义环境键和环境值扩展：

private struct BananaEnvironmentKey: EnvironmentKey {
    static let defaultValue = Banana()
}

extension EnvironmentValues {
    var banana: Banana {
        get { self[BananaEnvironmentKey.self] }
        set { self[BananaEnvironmentKey.self] = newValue }
    }
}

2. 在预览中使用键路径注入环境：

#Preview {
    ContentView()
        .environment(\.banana, Banana())
}

3. 在ContentView中通过键路径获取实例：

struct ContentView: View {
    @Environment(\.banana) private var banana
    
    var body: some View {
        Text(banana.ripe)
    }
}

方案3：使用@State包装实例 #

在#Preview闭包内用@State包装Banana实例，帮助SwiftUI正确推断类型：

#Preview {
    @State var banana = Banana()
    ContentView()
        .environment(banana)
}

原因分析 #

Xcode 15早期版本的#Preview宏在处理environment链式调用时，编译器无法正确推断View的重载方法，导致歧义调用错误。通过显式返回、明确环境键或使用@State包装实例，都能帮助编译器正确识别类型，解决预览崩溃问题。

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