如何在 Java 中利用 StringJoiner 设置空结果时的占位符以及自定义的起止符号

StringJoiner 构造时必须指定分隔符，前缀、后缀和空值占位符需在创建时通过三参数构造函数或 setEmptyValue() 显式设置，且不可后续修改；空值逻辑仅在从未调用 add() 时生效。

关于 Ja va 的 StringJoiner，有几个容易踩坑的点，先说几个关键判断：它本身并不提供“空集合时返回占位符”或者“自动带前缀后缀”的默认行为——这些都需要你明确指定。而且，前缀（prefix）、后缀（suffix）以及空值占位符（emptyValue）都是在构造时定死的，后续想改？没门儿。

很多人一开始会用 new StringJoiner(",") 创建实例，然后想当然地调用方法往里加前缀后缀——结果发现根本不存在这样的 setter 方法。正确的做法是直接用三参数构造器：new StringJoiner(delimiter, prefix, suffix)。占位符则必须通过 setEmptyValue(String) 显式设置，而且只能调用一次，重复调用会覆盖前值。如果从来没调用过 setEmptyValue，一个空的 StringJoiner 调用 toString() 返回的其实是 prefix + suffix，比如 "[]"，而不是空字符串——这一点特别容易让人意外。

空结果占位符只在没有任何 add() 调用时生效

这个规则非常严格：只有当 StringJoiner 从创建到现在一次 add() 都没被调过，toString() 才会返回你设置的占位符。哪怕你加了 add("")（空字符串），它也会被当作一个元素进入拼接流程，空值逻辑立刻失效。

举个例子：你准备拼接用户选中的标签列表，如果一个都没选，想显示空串。这时候必须确保一次 add() 都没执行。错误写法是 joiner.add(null) 或 joiner.add("") 之后再检查 size，实际上空状态已经被破坏了。更安全的做法是用一个布尔标记来记录是否添加过，或者自己记一下 add 次数——直接靠 joiner.length() == 0 判断要小心，因为 length 已经包含了 prefix 和 suffix 的长度。

起止符号与分隔符共同影响最终字符串结构

prefix 和 suffix 是纯粹的字面量包裹，不参与分隔逻辑。拿 new StringJoiner(",", "[", "]").setEmptyValue("[]") 来说：

• 空的时候返回 "[]"（由 setEmptyValue 决定）
• 加一个元素 "a"，返回 "[a]"（prefix + 元素 + suffix）
• 加两个元素 "a"、"b"，返回 "[a,b]"（prefix + 元素1 + 分隔符 + 元素2 + suffix）

注意，suffix 不会因为多次 add() 而重复出现，只会在结尾加一次；分隔符也只出现在元素之间，不会在开头或结尾多出一个。

替代方案：Apache Commons Lang 的 StringUtils.join 更灵活

如果平时需要频繁处理“空集合返回默认值”的场景，原生 StringJoiner 确实显得有点死板。比如从 List 拼接标签，得先判空再决定要不要 new Joiner。而 StringUtils.join(list, ",") 默认返回空字符串，配合 ObjectUtils.defaultIfNull 或三元表达式更直白：

String result = CollectionUtils.isEmpty(tags)     ? "<无标签>"     : String.join(", ", tags);

实际上，String.join（静态方法，底层也是基于 StringJoiner）加一个三元判断，比手动管理 StringJoiner 实例要轻量得多。真正需要 StringJoiner 的场景，主要是流式构建、中间可复用、或者必须精确控制 prefix/suffix 且确定非空的情况。

容易忽略的一点：StringJoiner 的 merge() 方法能合并两个 joiner，但前提是它们的 delimiter、prefix、suffix 必须完全一致，否则会抛出 IllegalArgumentException——在组合多个数据源时，这个约束可能意外触发，得格外留个心眼。