stringjoiner 原生支持分隔符、前缀和后缀,创建时指定三参数即可自动包裹元素;空集合返回前缀+后缀(如“[]”),无需判空;支持链式调用、merge合并及与collectors.joining无缝对应。

用 StringJoiner 拼接带前后缀的列表,关键在于它原生支持分隔符、前缀和后缀——不用自己拼字符串,也不用额外判断空集合或手动加括号。
创建时直接指定前缀、后缀和分隔符
这是最常用也最推荐的方式。构造函数接受三个参数:分隔符、前缀、后缀。只要传入,后续添加元素时会自动包裹。
- 例如:想把
["a", "b", "c"]拼成[a, b, c],直接写:
sj.add("a").add("b").add("c");
System.out.println(sj.toString()); // 输出 [a, b, c]
注意:如果没添加任何元素,toString() 返回的是空前缀 + 空后缀(即 "" → "[]"),这点很实用,避免空值判空逻辑。
对空集合也能安全处理
传统拼接常要先检查集合是否为空,再决定要不要加括号。StringJoiner 不需要——它天然“惰性”:没调用 add() 就不会插入分隔符,但前缀后缀照常生效。
- 比如空列表:
System.out.println(sj.toString()); // 输出 {}
这个特性让它特别适合生成 JSON 片段、日志格式、SQL IN 列表等场景,无需额外 if 判断。
可链式调用,也可复用或合并
add() 和 merge() 都返回 this,支持链式构建;merge() 还能合并另一个 StringJoiner(要求分隔符相同,否则忽略)。
- 链式示例:
.add("Java")
.add("Python")
.add("Go")
.toString(); // «Java | Python | Go»
- 合并两个同分隔符的 joiner:
StringJoiner b = new StringJoiner("-", "X", "X").add("3");
a.merge(b);
System.out.println(a.toString()); // X1-2-3X
和 Collectors.joining() 的关系
Stream 的 Collectors.joining(delimiter, prefix, suffix) 内部就是基于 StringJoiner 实现的。所以如果你在流式处理中拼接,优先用它更简洁:
String s = list.stream().collect(Collectors.joining(", ", "(", ")"));
// 结果:(x, y, z)
本质一样,只是封装了一层;需要复用或动态控制时,才显式用 StringJoiner 类。










