Java 8引入的Stream API为集合操作提供了极大的便利，其中Collectors工具类下的joining方法专门用于字符串合并场景，能够替代传统的循环拼接逻辑，让代码更加简洁易读。该方法支持多种参数配置，可以满足不同的字符串合并需求。
Collectors.joining基础用法
Collectors.joining有三个重载方法，最基础的无参方法会将集合中的所有字符串直接拼接成一个整体，中间没有任何分隔符。下面是一个简单的使用示例：
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
public class JoiningDemo {
public static void main(String[] args) {
List<String> strList = Arrays.asList("Java", "Python", "Go", "C++");
// 无参joining，直接拼接所有字符串
String result = strList.stream().collect(Collectors.joining());
System.out.println(result); // 输出：JavaPythonGoC++
}
}
带分隔符的合并方式
实际开发中更多场景需要在合并的字符串之间添加分隔符，比如逗号、空格等，这时可以使用带一个参数的joining方法，参数就是指定的分隔符。示例如下：
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
public class JoiningDemo2 {
public static void main(String[] args) {
List<String> fruitList = Arrays.asList("苹果", "香蕉", "橙子", "葡萄");
// 使用逗号作为分隔符合并字符串
String fruitStr = fruitList.stream().collect(Collectors.joining(","));
System.out.println(fruitStr); // 输出：苹果,香蕉,橙子,葡萄
// 使用空格作为分隔符
String spaceStr = fruitList.stream().collect(Collectors.joining(" "));
System.out.println(spaceStr); // 输出：苹果 香蕉 橙子 葡萄
}
}
带前缀和后缀的合并方式
如果需要在合并后的字符串前后添加固定的前缀和后缀，可以使用三个参数的joining方法，参数依次是分隔符、前缀、后缀。这种方式常见于生成格式化的字符串，比如拼接SQL的IN条件、生成数组格式的字符串等。示例如下：
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
public class JoiningDemo3 {
public static void main(String[] args) {
List<String> idList = Arrays.asList("1001", "1002", "1003", "1004");
// 拼接成SQL IN条件的格式：('1001','1002','1003','1004')
String inCondition = idList.stream().collect(Collectors.joining("','", "('", "')"));
System.out.println(inCondition); // 输出：('1001','1002','1003','1004')
// 拼接成数组格式的字符串
List<String> nameList = Arrays.asList("张三", "李四", "王五");
String arrayStr = nameList.stream().collect(Collectors.joining(", ", "[", "]"));
System.out.println(arrayStr); // 输出：[张三, 李四, 王五]
}
}
合并非字符串类型的集合元素
如果集合中的元素不是字符串类型，比如是整数、自定义对象等，需要先通过map方法将元素转换为字符串，再使用Collectors.joining合并。如果是自定义对象，通常需要调用对象的toString方法或者指定需要拼接的字段。示例如下：
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
class User {
private String name;
private int age;
public User(String name, int age) {
this.name = name;
this.age = age;
}
public String getName() {
return name;
}
}
public class JoiningDemo4 {
public static void main(String[] args) {
// 合并整数集合
List<Integer> numList = Arrays.asList(10, 20, 30, 40);
String numStr = numList.stream().map(String::valueOf).collect(Collectors.joining("-"));
System.out.println(numStr); // 输出：10-20-30-40
// 合并自定义对象集合，拼接用户名称
List<User> userList = Arrays.asList(
new User("张三", 20),
new User("李四", 22),
new User("王五", 25)
);
String userNames = userList.stream().map(User::getName).collect(Collectors.joining("、"));
System.out.println(userNames); // 输出：张三、李四、王五
}
}
常见注意事项
- 如果集合中存在null元素，使用Collectors.joining会直接拼接null的字符串形式，也就是"null"，如果需要过滤null元素，需要先使用filter方法过滤。
- Collectors.joining内部是通过StringBuilder实现的，性能上比手动循环拼接更优，尤其是处理大集合时优势更明显。
- 如果集合为空，使用Collectors.joining会返回空字符串，不会抛出异常，这一点比手动处理空集合的逻辑更友好。
通过上述示例可以看出，Collectors.joining能够覆盖绝大多数集合字符串合并的场景，代码简洁且可读性高，是Java开发中处理字符串合并的首选方式。开发者可以根据实际需求选择合适的重载方法，灵活配置分隔符、前缀和后缀，提升开发效率。
JavaCollectors.joining字符串合并集合操作Stream_API修改时间：2026-07-15 18:21:26