StringJoiner连接字符串详解

StringJoiner 是 Java 中专为结构化字符串拼接设计的轻量工具，特别适合已知元素集合、需统一添加分隔符及前后缀（如生成 "[a,b,c]" 格式）的场景，相比手动拼接更安全清晰，但并不适用于单次两字符串连接、动态增删中间元素或高频循环拼接；其构造函数参数顺序（分隔符、前缀、后缀）易出错，add() 用于追加单个元素（null 被转为字符串"null"），merge() 则合并另一 StringJoiner 的内容并复用当前分隔符；在实际开发中，应根据上下文理性选择：List 拼接优先用 String.join()，Stream 流处理首选 Collectors.joining()，仅当需要逐步构建、条件添加或跨 joiner 合并时，StringJoiner 才真正发挥不可替代的价值。

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() 怎么选

三者底层都复用类似逻辑，性能差异可忽略。关键看代码上下文和可读性：

• 已有 List？直接用 String.join(",", list) 最简洁
• 在 Stream 处理中？用 collect(Collectors.joining(", ", "[", "]")) 语义最连贯
• 需要逐步构建（比如条件性 add、中途 merge 其他 joiner）？才值得用 StringJoiner 实例
• 注意：StringJoiner 没有 toString() 以外的不可变方法，一旦 build 就只能靠新建实例，别试图复用它来“重置”

最容易被忽略的一点：如果你只是拼接常量或两三个变量，别为了“用新 API”硬套 StringJoiner——它带对象创建开销，而 "a" + "," + "b" 在编译期就优化成常量了。

今天关于《StringJoiner连接字符串详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！