StringJoiner适合已知元素集合、需统一分隔符及前后缀的字符串拼接场景;不适合单次两字符串拼接或动态增删元素,构造函数参数顺序为分隔符、前缀、后缀,add添加元素,merge合并另一joiner内容。

StringJoiner 适合什么场景
当你要拼接一组字符串、中间加固定分隔符,且可能需要前缀和后缀(比如 [a, b, c] 这种格式),StringJoiner 比手动用 + 或 StringBuilder 更清晰安全。它不是为高频循环拼接设计的,也不适合动态插入/删除中间元素——那是 ArrayList + String.join() 的事。
- 适合:已知元素集合(如
List)、需统一分隔符+包裹符号 - 不适合:单次拼接两个字符串(直接用
+更轻量) - 不适合:边遍历边决定是否加入某项(容易漏掉分隔符逻辑,用
Stream.collect(Collectors.joining())更稳)
构造函数参数顺序容易搞反
StringJoiner 的三个构造函数中,最常用的是 new StringJoiner(delimiter, prefix, suffix)。注意:参数顺序是「分隔符、前缀、后缀」,不是「前缀、分隔符、后缀」。写错会导致前缀被当成分隔符塞进中间,或者后缀根本不出现在结果里。
常见错误现象:new StringJoiner("[", ",", "]") → 拼出 [a,b,c]?错,实际是 a[b,c[(因为 "[" 被当成分隔符,"]" 是后缀但没元素时不会出现)
正确写法:new StringJoiner(",", "[", "]") → 空实例时输出 [];加了 "a"、"b" 后输出 [a,b]
add() 和 merge() 的行为差异
add() 往当前实例追加一个元素;merge() 把另一个 StringJoiner 的所有已添加元素(不含其前缀/后缀)合并进来,用当前的分隔符连接。
-
add(null)不会抛空指针,而是加入字符串"null"(这点和Objects.toString()一致) -
merge()对空的StringJoiner无影响;对非空的,只合并内容,不叠加前缀/后缀 - 如果两个
StringJoiner分隔符不同,merge()仍用调用方的分隔符,被合并方的分隔符被忽略
示例:
sj1 = new StringJoiner("-", "A", "Z"); sj1.add("x");
sj2 = new StringJoiner("|", "P", "Q"); sj2.add("y").add("z");
sj1.merge(sj2); // 结果是 "Ax-y-zZ",不是 "AxyzzZ" 或带 P/Q
和 String.join()、Collectors.joining() 怎么选
三者底层都复用类似逻辑,性能差异可忽略。关键看代码上下文和可读性:
立即学习“Java免费学习笔记(深入)”;
- 已有
List?直接用String.join(",", list)最简洁 - 在 Stream 处理中?用
collect(Collectors.joining(", ", "[", "]"))语义最连贯 - 需要逐步构建(比如条件性 add、中途 merge 其他 joiner)?才值得用
StringJoiner实例 - 注意:
StringJoiner没有toString()以外的不可变方法,一旦 build 就只能靠新建实例,别试图复用它来“重置”
最容易被忽略的一点:如果你只是拼接常量或两三个变量,别为了“用新 API”硬套 StringJoiner——它带对象创建开销,而 "a" + "," + "b" 在编译期就优化成常量了。









