StringJoiner适用于已预处理非空元素且需固定前后缀的集合拼接，不支持null处理、动态条件或嵌套结构；构造时须用三参指定分隔符及前后缀，add后不可修改参数，空集合返回prefix+suffix。
StringJoiner 用在哪？不是所有拼接都适合它
当你需要把集合元素按固定分隔符拼成字符串，且可能要加前后缀（比如 [a, b, c] 这种带方括号和逗号空格的格式），StringJoiner 比手写循环或 String.join() 更直接。但它不处理 null 元素、不支持 lambda 过滤、也不自动 trim 或转义——这些得你提前做。
常见错误现象：NullPointerException 直接抛出，因为 StringJoiner.add(null) 不允许；或者误以为它能像 Collectors.joining() 那样在 stream 里自动跳过 null，其实不能。
- 适用场景：已知集合非空，或已手动过滤/转换好元素（如
list.stream().map(Objects::toString).collect(...)） - 不适用场景：需要动态条件拼接（比如“只拼非空字段”）、要处理嵌套结构、或需格式化数字/日期
- 性能影响：比纯 StringBuilder 略重一点（多了前缀/后缀逻辑），但差距可忽略；比反复用
+拼接快得多
构造时三个参数怎么选？别漏掉后缀
StringJoiner 构造函数是 new StringJoiner(delimiter, prefix, suffix)，很多人只传一个 delimiter，结果发现前后缀根本加不上——因为单参构造器只设分隔符，prefix 和 suffix 默认为空字符串，之后没法再改。
正确做法：需要前后缀，必须一步到位用三参构造。例如拼 JSON 数组风格：new StringJoiner(",", "[", "]")。
立即学习“Java免费学习笔记（深入）”；
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
- 如果只要分隔符，用
String.join(delimiter, iterable)更简洁，不用 new 对象 -
prefix和suffix是静态的，不能根据元素个数变化（比如“一个元素时不加中括号”——这得自己判断） - 空集合调用
toString()会返回prefix + suffix（如"[]"），不是空字符串，这点常被忽略
add() 之后还能改分隔符吗？不能，别试
StringJoiner 的 delimiter、prefix、suffix 全是 final 字段，构造完就锁死了。调用 add() 后想换分隔符？不行。试图重新 new 一个再 add 原有内容？也没法取到中间状态——它不提供 getDelimiter() 或类似方法。
典型踩坑：写了个工具方法，想复用同一个 StringJoiner 实例拼不同格式，结果后一次拼接沿用了前一次的分隔符。
- 每次需要不同格式，就 new 新的
StringJoiner - 如果逻辑复杂（比如根据字段类型切分不同分隔符），不如直接用
StringBuilder手动控制 - 注意
merge()方法只合并另一个StringJoiner的内容，不改变自身分隔符，且要求两个 joiner 的prefix/suffix必须完全一致，否则抛IllegalArgumentException
和 Collectors.joining() 什么关系？别混用
Collectors.joining() 内部就是用 StringJoiner 实现的，但它是为 stream 设计的终端操作，封装了创建、添加、合并全过程。你手动 new StringJoiner 是为了更细粒度控制（比如中途插入条件逻辑），不是为了替代它。
容易混淆的点：有人把 StringJoiner 当成 Collectors.joining() 的“低阶 API”，然后在 stream 里自己 add 元素——这反而绕路，还容易出并发问题（StringJoiner 不是线程安全的）。
- stream 场景，优先用
Collectors.joining(delim, pre, suf) - 非 stream 场景（比如 for 循环中逐个判断是否添加），才用
StringJoiner手动add() - 不要在多线程里共享一个
StringJoiner实例；并发拼接请用ConcurrentHashMap分桶或改用线程安全的收集方式
最常被忽略的是空集合行为和 null 安全——它不帮你兜底，也不会静默跳过 null。该判空的地方还得判，该 toString() 的地方不能少。其它都是次要的。
