SwiftUI中创建ToolbarContent类型@State变量报错的解决方法

错误原因说明 #

你遇到的错误源于两个关键点：

• some ToolbarContent是不透明返回类型，无法直接作为@State变量的存储类型；
• @ToolbarContentBuilder修饰的属性必须是只读（仅包含getter），不能用于定义可赋值的变量。

下面提供两种可行的解决方案：

方案一：用枚举标识Toolbar类型（推荐） #

这种方法类型安全、逻辑清晰，适合Toolbar样式固定的场景：

1. 定义枚举标记不同Toolbar类型

enum ToolbarStyle {
    case main
    case edit
    case settings
}

2. 在View中用@State管理当前选中的Toolbar类型

@State private var currentToolbarStyle: ToolbarStyle = .main

3. 用@ToolbarContentBuilder定义各个Toolbar

@ToolbarContentBuilder private var mainToolbar: some ToolbarContent {
    ToolbarItem(placement: .navigationBarTrailing) {
        Button("进入编辑") {
            currentToolbarStyle = .edit
        }
    }
}

@ToolbarContentBuilder private var editToolbar: some ToolbarContent {
    ToolbarItem(placement: .navigationBarLeading) {
        Button("取消") {
            currentToolbarStyle = .main
        }
    }
    ToolbarItem(placement: .navigationBarTrailing) {
        Button("保存") { /* 执行保存逻辑 */ }
    }
}

@ToolbarContentBuilder private var settingsToolbar: some ToolbarContent {
    ToolbarItem(placement: .navigationBarTrailing) {
        Button("重置") { /* 执行重置逻辑 */ }
    }
}

4. 在toolbar修饰器中根据枚举切换Toolbar

var body: some View {
    NavigationStack {
        Text("页面内容")
            .toolbar {
                switch currentToolbarStyle {
                case .main:
                    mainToolbar
                case .edit:
                    editToolbar
                case .settings:
                    settingsToolbar
                }
            }
    }
}

方案二：自定义可擦除ToolbarContent类型 #

如果需要更灵活的动态Toolbar切换（比如从外部传入Toolbar），可以用类型擦除包装器：

1. 实现AnyToolbarContent类型擦除结构体

struct AnyToolbarContent: ToolbarContent {
    private let content: () -> any ToolbarContent
    
    init<T: ToolbarContent>(_ content: @autoclosure @escaping () -> T) {
        self.content = content
    }
    
    var body: some ToolbarContent {
        content() as! some ToolbarContent
    }
}

2. 用@State存储AnyToolbarContent实例

@State private var currentToolbar: AnyToolbarContent = AnyToolbarContent(mainToolbar)

3. 切换Toolbar时直接赋值新的包装实例

Button("切换到设置") {
    currentToolbar = AnyToolbarContent(settingsToolbar)
}

4. 在toolbar中直接使用currentToolbar

.toolbar {
    currentToolbar
}

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