怎么利用 Stream.builder() 手动构建一个包含特定业务对象的流

说白了，Stream.builder() 就是给那种“就这么几个明确的对象，不想专门建个 List”的场景准备的。比如在单元测试里硬塞两三个用户对象，或者在 lambda 表达式里临时拼凑一小批数据——这时候用它挺顺手。但它**不适合做大批量元素填充**，更不是 List.of(...).stream() 的替代品。

为什么？因为 builder 内部走的是可变数组缓冲区，等 build() 调用时才真正冻结并生成不可变流。如果你往里塞上千个元素，每次 add() 都会触发数组扩容和拷贝，那还不如老老实实 ArrayList 加循环来得直接。所以记住：小批量、确定值、动态拼接——这才是它的主场。

正确调用三步走，一步都不能少

拿到 Stream.builder() 后，流程极其死板：先获取 builder 实例 → 一个个调用 add() 往里塞 → 最后必须来一句 build() 生成真正的流。漏掉最后一步？那你拿到的是 Stream.Builder 对象，不是 Stream，后续 map、filter 全都会编译报错。

• Stream.builder() 返回的是 Stream.Builder，不是 Stream —— 别搞混了
• 每个 add() 只接受一个元素，不能传集合或数组，想批量加就得循环调 add
• build() 只能调用一次，重复调用会抛 IllegalStateException

来个实际例子（Ja va 17 风格）：

Stream userStream = Stream.builder()
    .add(new User("Alice", 28))
    .add(new User("Bob", 32))
    .add(new User("Charlie", 25))
    .build(); // 这行不能少

泛型推断？别指望了，老老实实写尖括号

很多新手在这栽跟头：Stream.builder() 是静态方法，JVM 在类型擦除后根本没法从 add() 的参数里反推泛型。因为 add() 的签名是 void add(T t)，而 builder 实例本身没有类型锚点。你不写 ，编译器大概率推成 Stream