新手指南：怎么使用StringJoiner优雅地拼接带有前后缀的列表

在Java开发中，字符串拼接是高频操作，尤其是需要给拼接结果添加固定前缀、后缀，同时用特定分隔符连接列表元素的场景，传统使用StringBuilder循环拼接的方式不仅代码繁琐，还容易出现遗漏分隔符或者前后缀的问题。StringJoiner作为Java 8新增的工具类，专门解决了这类拼接痛点，支持直接设置分隔符、前缀和后缀，使用起来非常简洁。

StringJoiner基础概念

StringJoiner位于java.util包下，核心作用是按照指定规则拼接多个字符串。它的构造方法主要有两个重载形式，分别对应是否需要前后缀的场景：

• StringJoiner(CharSequence delimiter)：仅指定分隔符，无前后缀
• StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix)：指定分隔符、前缀、后缀

拼接带前后缀列表的基本用法

假设我们有一个字符串列表，需要将其拼接为以[开头、]结尾，元素之间用,分隔的格式，比如将["apple", "banana", "orange"]拼接为[apple,banana,orange]，使用StringJoiner的实现方式如下：

import java.util.StringJoiner;
import java.util.Arrays;
import java.util.List;

public class StringJoinerDemo {
    public static void main(String[] args) {
        // 待拼接的列表
        List<String> fruitList = Arrays.asList("apple", "banana", "orange");
        // 创建StringJoiner，指定分隔符为逗号，前缀为[，后缀为]
        StringJoiner stringJoiner = new StringJoiner(",", "[", "]");
        // 遍历列表添加元素
        for (String fruit : fruitList) {
            stringJoiner.add(fruit);
        }
        // 获取拼接结果
        String result = stringJoiner.toString();
        System.out.println(result); // 输出：[apple,banana,orange]
    }
}

结合Stream流简化操作

在Java 8及以上版本中，Collectors.joining方法底层就是基于StringJoiner实现的，如果已经在使用Stream流处理列表，可以直接通过收集器完成拼接，代码更加简洁：

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class StringJoinerStreamDemo {
    public static void main(String[] args) {
        List<String> fruitList = Arrays.asList("apple", "banana", "orange");
        // 使用Stream的collect方法，直接指定分隔符、前缀、后缀
        String result = fruitList.stream()
                .collect(Collectors.joining(",", "[", "]"));
        System.out.println(result); // 输出：[apple,banana,orange]
    }
}

空值处理与特殊场景

如果列表中可能存在空值，直接拼接会出现null字符串，这时候可以在添加元素前做过滤，或者提前处理空值：

import java.util.StringJoiner;
import java.util.Arrays;
import java.util.List;
import java.util.Objects;

public class StringJoinerNullDemo {
    public static void main(String[] args) {
        List<String> fruitList = Arrays.asList("apple", null, "orange");
        StringJoiner stringJoiner = new StringJoiner(",", "[", "]");
        for (String fruit : fruitList) {
            // 过滤空值，避免拼接出null字符串
            if (Objects.nonNull(fruit)) {
                stringJoiner.add(fruit);
            }
        }
        System.out.println(stringJoiner.toString()); // 输出：[apple,orange]
    }
}

传统拼接方式与StringJoiner对比

使用传统StringBuilder实现同样的前后缀列表拼接，代码会明显更长，且需要手动处理分隔符的添加逻辑，很容易出现多拼接或者少拼接分隔符的问题：

import java.util.List;
import java.util.Arrays;

public class StringBuilderDemo {
    public static void main(String[] args) {
        List<String> fruitList = Arrays.asList("apple", "banana", "orange");
        StringBuilder sb = new StringBuilder();
        sb.append("[");
        for (int i = 0; i < fruitList.size(); i++) {
            sb.append(fruitList.get(i));
            // 手动判断是否需要添加分隔符，容易出错
            if (i != fruitList.size() - 1) {
                sb.append(",");
            }
        }
        sb.append("]");
        System.out.println(sb.toString()); // 输出：[apple,banana,orange]
    }
}

通过对比可以明显看出，StringJoiner把前后缀和分隔符的逻辑内置，开发者只需要关注要拼接的元素即可，大幅降低了出错概率，也让代码更加简洁易读。

StringJoinerJava字符串拼接前后缀拼接列表拼接Java工具类修改时间：2026-06-26 21:00:22