stringjoiner是java 8引入的专用于带分隔符动态拼接的工具类，适用于需多次add、支持前后缀、解耦拼接逻辑的场景，如sql条件、http参数构建；构造时注意delimiter在前、prefix/suffix在后，且不可修改，空值需手动过滤。
StringJoiner 是什么，适合在哪儿用
StringJoiner 是 Java 8 引入的轻量工具类，专为「带分隔符的字符串拼接」设计。它不是用来替代 StringBuilder 的通用构建器，也不是为了取代 String.join() 这种一次性操作——它的价值在于需要**多次、动态、可复用地追加片段**的场景，比如构建 SQL WHERE 条件、HTTP 查询参数、日志上下文标签。
常见错误是把它当 StringBuilder 用：反复 add() 后又想插入前缀或改分隔符，结果发现不可逆；或者误以为它比 String.join() 快很多，其实单次拼接时 JVM 优化后差距微乎其微。
适用场景包括：
- 循环中逐个添加非空字段，最后生成逗号分隔列表
- 构建配置项字符串，需支持设置前缀（如
"["）和后缀（如"]"） - 作为方法返回值被外部继续
add()，实现拼接逻辑解耦
构造函数参数顺序容易搞反
StringJoiner 有三个构造函数，最常用的是两个参数版本：new StringJoiner(delimiter, prefix, suffix)。注意：**分隔符在前，前后缀在后**——这不是直觉顺序，很多人写成 new StringJoiner("[", ", ", "]")，结果拼出来是 "[a, b, c"，因为 "[" 被当成了分隔符。
正确写法示例：
StringJoiner sj = new StringJoiner(", ", "[", "]");
sj.add("apple").add("banana").add("cherry");
// 结果："[apple, banana, cherry]"
关键点：
- 如果不需要前后缀，只传
delimiter即可，如new StringJoiner(", ") -
prefix和suffix在空StringJoiner时也会输出（即new StringJoiner(", ", "{", "}") → "{}"） - 一旦构造完成，
delimiter、prefix、suffix都不可修改
add() 空字符串或 null 会照单全收
StringJoiner.add() 不做任何空值检查。传入 null 会变成字符串 "null"，传入空字符串 "" 就真的加一个空段——这常导致意外的多余分隔符或脏数据。
比如：
StringJoiner sj = new StringJoiner(" | ");
sj.add("A").add(null).add("").add("C");
// 结果："A | null | | C"
所以必须自己过滤：
- 用
Objects.nonNull(s) && !s.isEmpty()判断再add() - 别依赖
StringJoiner做业务校验，它只是拼接器，不是验证器 - 如果源数据来自 JSON 或用户输入，
null更常见，漏判会导致线上日志出现大量"null"
性能和 StringBuilder / String.join() 怎么选
单纯比吞吐量：String.join() ≈ StringJoiner > 手动用 StringBuilder 拼接（因避免了中间字符串创建）。但三者差异在纳秒级，除非在 tight loop 里调用上万次，否则不用纠结。
真正影响选择的是**使用模式**：
- 一次性拼接固定集合？直接用
String.join(", ", list)，语义清晰、代码短
- 需要中途判断是否添加某段？用
StringJoiner，靠 add() 的条件调用控制输出内容
- 要插入选项、修改分隔符、或混合其他字符串操作？老实用
StringBuilder，StringJoiner 的 API 太封闭
还有一个隐形坑：Android 低版本（API StringJoiner，如果项目还要兼容旧系统，得 fallback 到 TextUtils.join() 或自行封装。
事情说清了就结束。
String.join(", ", list)，语义清晰、代码短StringJoiner，靠 add() 的条件调用控制输出内容StringBuilder，StringJoiner 的 API 太封闭
