Collectors.joining()是Java Stream API中用于字符串聚合的专用工具，提供无参、单参、三参三种重载形式，支持分隔符、前缀、后缀定制，并自动处理空流和单元素流，内部基于StringBuilder实现高效拼接。
Java Stream API 的 Collectors.joining() 是处理字符串聚合最直接、最常用的工具之一。它专为流中字符串（或可转为字符串）元素设计，无需手动遍历或拼接，一行 collect 就能完成连接任务。
三种常用重载形式
joining 提供三个核心重载方法，覆盖绝大多数连接场景：
-
无参版：
Collectors.joining()—— 直接拼接，不加任何分隔符。适合数字序列、密钥片段等紧凑拼接需求。 -
单参版：
Collectors.joining(", ")—— 指定分隔符。最常用，如生成逗号分隔的列表、SQL IN 子句参数等。 -
三参版：
Collectors.joining(" | ", "[", "]")—— 同时指定分隔符、前缀和后缀。适合构造带格式的输出，比如日志标签、JSON 数组模拟、SQL 字符串包裹等。
处理非字符串类型数据
Stream 中的元素不一定是 String，但 joining 要求 CharSequence。因此需先用 map 转换：
- 对对象：用
map(Person::getName)或map(Object::toString) - 对数字：用
map(String::valueOf)或map(Object::toString) - 注意：若对象 toString() 返回 null，会抛出 NullPointerException；建议提前 filter 或 map 时做空值保护，例如
map(p -> p != null ? p.getName() : "")
空流与单元素流行为
joining 对边界情况处理得非常自然：
立即学习“Java免费学习笔记（深入）”；
- 空流（如
Stream.empty()）→ 返回空字符串"" - 单元素流（如
Stream.of("hello")）→ 直接返回该元素，不添加分隔符、前缀或后缀 - 这意味着你无需额外判空，代码更简洁健壮
性能与替代方案对比
joining 内部使用 StringBuilder 实现，效率接近手写拼接。但在某些场景下可考虑替代方式：
- 如果原始数据已是
List<String>，直接用String.join(", ", list)更轻量，省去 stream 构建开销 - 若需复杂逻辑（如条件跳过、动态分隔符），可配合
filter+joining，比 StringBuilder 手动控制更声明式 - 极端大数据量且性能敏感时，可考虑预估容量初始化 StringBuilder，但日常开发中 joining 完全够用
不复杂但容易忽略：记住 joining 是 Collector，必须用在 collect() 中，不是 Stream 上的独立方法。
