@ViewBuilder：是什么，SwiftUI 中用于 View 的 result builder

SwiftUI 中的 @ViewBuilder 是什么？

@ViewBuilder — 是一个实现 result builder 模式 (SE-0289) 的注解，允许 SwiftUI 使用声明式语法将多个 View 收集到一个组合中。它会自动将多个表达式、条件结构和可选值包装到相应类型中：TupleView、ConditionalContent、OptionalContent。

在 result builder 出现之前，开发人员必须手动将元素包装到 VStack 或 HStack 中，对于条件逻辑需要使用三元运算符或工厂方法。@ViewBuilder 使 SwiftUI 语法简洁易读，允许编写看起来像带有 if/else 和循环的普通 Swift 的代码。

根据 Swift Evolution SE-0289，result builders 是一种通用机制，不局限于 SwiftUI。@ViewBuilder 是该机制的实现之一，与用于构建字符串的 @StringBuilder 和其他 DSL 的库实现并列。在 SwiftUI 中，@ViewBuilder 不仅用于 body，还用于容器的闭包参数（VStack、HStack、ZStack、List）。

与命令式方法的区别

在命令式 UIKit 中，你命令式地创建 UIView，配置其属性并通过 addSubview 将其添加到层次结构中。在带有 @ViewBuilder 的 SwiftUI 中，你声明式地描述哪些 View 应该被显示，而 SwiftUI 本身根据状态变化管理元素的创建、更新和删除。

@ViewBuilder 如何工作：result builder

Result builder — 是一种 Swift 机制，通过静态方法 buildBlock、buildOptional、buildEither 等将一系列表达式转换为一个复合值。当编译器看到 @ViewBuilder 注解时，它会在编译过程中自动将这些方法应用于代码块。

@resultBuilder
struct ViewBuilder {
    static func buildBlock<C0, C1>(_ c0: C0, _ c1: C1) -> TupleView<(C0, C1)>
    static func buildIf<C>(_ c: C?) -> C?
    static func buildEither<T, F>(first: T) -> ConditionalContent<T, F>
    static func buildEither<T, F>(second: F) -> ConditionalContent<T, F>
}

buildBlock 接受 1 到 10 个表达式并返回 TupleView。每个参数数量（表达式数量）都有自己对应的 buildBlock 重载：从 buildBlock<C0> 到 buildBlock<C0, C1, ..., C9>。这正是为什么一个 @ViewBuilder 块中的元素数量限制为 10 个。

buildEither（first/second）处理 if/else 结构。每个分支被传递到相应的方法，结果被包装到 ConditionalContent 中——这是一种隐藏分支具体类型并为 SwiftUI 提供统一接口的类型。

@ViewBuilder 的隐式工作

在 SwiftUI 中，body 属性已经隐式地用 @ViewBuilder 注解了——你在代码中看不到这个注解，但编译器会自动应用它。然而，对于返回多个 View 的用户属性或闭包参数，需要显式指定注解。

@ViewBuilder 的限制以及如何绕过它们

限制 1 — 一个块中 10 个元素。 这是 @ViewBuilder 最著名的限制。如果需要在同一级别显示超过 10 个元素，编译器将报错。可以通过 Group、ForEach、List 或拆分为子组件来绕过。Group 不添加视觉嵌套，但每个 Group 算作一个元素。

struct ManyElementsView: View {
    var body: some View {
        Group {
            Text("1"); Text("2"); Text("3")
            Text("4"); Text("5"); Text("6")
            Text("7"); Text("8"); Text("9")
        }
        Group {
            Text("10"); Text("11"); Text("12")
        }
    }
}

限制 2 — 不支持某些结构。 @ViewBuilder 不支持 do/catch、guard、for-in（没有 ForEach）和其他控制结构。对于循环，使用 ForEach 和可识别数据。对于错误处理，使用接受 Result 或可选值的单独 View。

限制 3 — 调试困难。 在 @ViewBuilder 出现错误时，编译器会生成冗长的消息，很难在其中找到根本原因。典型问题：if/else 分支中的类型不匹配、超过 10 个元素的限制或缺少所需的 buildBlock 重载。

@ViewBuilder 的使用模式

模式 1：通过 if/else 进行条件显示。 @ViewBuilder 最常用的场景。允许根据状态显示不同的 View，而无需使用三元运算符或工厂方法。

struct StatusView: View {
    var status: LoadStatus

    @ViewBuilder
    var body: some View {
        switch status {
        case .loading:
            ProgressView("Loading...")
        case .loaded(let data):
            DataView(data: data)
        case .error(let message):
            ErrorView(message: message)
        }
    }
}

模式 2：函数和初始化器参数中的 @ViewBuilder。 用于创建通过闭包接收子 View 的可复用容器。这是库和 UI 组件的标准模式。

struct SectionCard<Content: View>: View {
    let title: String
    @ViewBuilder let content: Content

    var body: some View {
        VStack(alignment: .leading) {
            Text(title).font(.headline)
            content
        }
        .padding()
        .background(Color.gray.opacity(0.1))
        .cornerRadius(12)
    }
}

模式 3：与 ForEach 的组合。 @ViewBuilder 与 ForEach 正确配合，允许从数据数组动态生成元素。每个 ForEach 元素在 @ViewBuilder 上下文中计为一个表达式。

为可复用组件创建自定义 ViewBuilder

自定义 ViewBuilder — 是用 @ViewBuilder 注解的用户函数或属性，返回 some View。这类函数允许封装复杂的显示逻辑并在应用程序的不同部分重用它。

struct FormRow<Content: View>: View {
    let label: String
    @ViewBuilder let content: Content

    var body: some View {
        HStack {
            Text(label)
                .frame(width: 120, alignment: .trailing)
            content
        }
    }
}

// 使用：
FormRow(label: "Name") {
    TextField("Enter name", text: $name)
}

FormRow(label: "Gender") {
    Picker("Select", selection: $gender) {
        Text("男").tag(Gender.male)
        Text("女").tag(Gender.female)
    }
}

重要规则：带有 @ViewBuilder 的自定义函数必须返回 some View，而不是具体类型或 View 协议。只有不透明类型（opaque type）才能隐藏具体实现并保持组合的灵活性。

性能：自定义 @ViewBuilder 函数与 body 中的直接代码相比不会增加开销。编译器内联调用并优化生成的代码。将 body 拆分为 @ViewBuilder 函数可提高可读性而不会损失性能。