Java StringJoiner 怎么拼带前后缀的列表：空集合、嵌套分隔和流式收集

做标签、权限列表或查询条件导出时，最容易留下的不是业务 bug，而是多一个逗号、少一个括号。Java 的 StringJoiner 把分隔符、前缀和后缀放到对象配置里，空集合也能得到可预测的结果；如果数据本来就在 Stream 中，还可以直接用 Collectors.joining 完成同样的拼接。

StringJoiner 解决的不是“加逗号”这么简单

手动拼接通常从一个 StringBuilder 开始，然后在循环里判断是不是第一个元素。列表一旦允许为空，或者输出格式从 a,b 改成 [a, b]，判断逻辑就会散落在循环里。

StringJoiner 的构造参数把三件事固定下来：元素之间用什么 delimiter，整体从什么 prefix 开始，以什么 suffix 结束。最小例子如下：

StringJoiner joiner = new StringJoiner(", ", "[", "]");
joiner.add("Java").add("JVM").add("集合");

System.out.println(joiner); // [Java, JVM, 集合]

这里的链式调用只是返回当前对象，适合在一段连续的组装逻辑里使用。若元素来自不可信输入，拼接本身不会替你做 HTML 转义、SQL 参数绑定或日志脱敏，这些仍然要在数据进入输出层之前完成。

先把空集合的输出定下来

没有任何元素时，StringJoiner 仍然会按前缀和后缀输出：

StringJoiner empty = new StringJoiner(", ", "[", "]");
System.out.println(empty.toString()); // []
System.out.println(empty.length());   // 2

StringJoiner plain = new StringJoiner(", ");
System.out.println(plain);             // 空字符串

这两个结果适合不同的接口契约。JSON 数组文本可以接受 []，而 SQL 的 IN (...) 不能因为“有一个空字符串”就安全执行。更稳的做法是先在业务层判断集合是否为空，决定返回空列表、跳过查询，还是走明确的无结果分支。

前缀和后缀只包住整个结果

prefix 与 suffix 不会包住每个元素。下面的结果只有一对方括号：

StringJoiner paths = new StringJoiner(" / ", "ROOT{", "}");
paths.add("api").add("v1").add("users");

// ROOT{api / v1 / users}
System.out.println(paths);

如果每个元素都需要自己的包裹符号，例如 "

merge 合并时不会重复套壳

把两个分组结果合成一个列表时，可以使用 merge：

StringJoiner backend = new StringJoiner(", ", "[", "]");
backend.add("Java").add("JVM");

StringJoiner tools = new StringJoiner(", ", "[", "]");
tools.add("Maven").add("Git");

backend.merge(tools);
System.out.println(backend); // [Java, JVM, Maven, Git]
System.out.println(tools);   // [Maven, Git]

合并后，目标 joiner 使用自己的分隔符、前缀和后缀；源 joiner 的内容被视为一个整体加入目标。也就是说，结果不会变成 [Java, JVM, [Maven, Git]]。源对象不会因此被清空，适合在多个输出分支中复用。

Stream 场景用 Collectors.joining 更顺手

当数据已经是流时，Collectors.joining 省掉了显式创建 joiner 的步骤：

List tags = List.of("Java", "JVM", "集合");

String text = tags.stream()
        .filter(Objects::nonNull)
        .collect(Collectors.joining(", ", "[", "]"));

System.out.println(text); // [Java, JVM, 集合]

它同样支持只传分隔符，或者同时传分隔符、前缀和后缀。过滤空值时要先确认业务语义：把空值忽略和把空值显示成占位符不是一回事。如果要求保留位置，可以显式映射成 "(empty)"，不要静默丢掉。

选择方式时看输入形态和输出契约

常见问题

StringJoiner 没有元素时会返回 null 吗？

不会。调用 toString() 会返回字符串；有前缀和后缀时通常是两者直接相邻，没有元素本身参与分隔。

merge 会把两个结果拼成嵌套列表吗？

不会。目标 joiner 会把源 joiner 的内容作为一组元素内容合并，最终仍使用目标的分隔符、前缀和后缀。

StringJoiner 能直接生成 JSON 吗？

只能拼出看起来像 JSON 的文本，不能替代 JSON 序列化器。字符串中包含引号、换行或反斜杠时，应该交给 JSON 库负责转义。

Stream 中有 null 元素怎么办？

先按接口契约选择忽略、替换或报错。若选择忽略，可以在 joining 前过滤；若需要保留位置，则先映射成明确的占位文本。

最后用三组输入做验收

提交前至少用“两个普通元素”“一个元素”和“空集合”跑一遍，并分别核对分隔符是否只出现在元素之间、前后缀是否只出现一次、空集合是否符合接口约定。若代码由 Stream 产生，再补一组含 null 的输入。这样比只看一条正常输出更容易抓住格式契约问题。