Java数组打印原理与5种正确方法详解

1. 为什么Java数组直接打印会显示乱码？

当你第一次在Java中尝试直接打印数组时，可能会遇到类似[I@1b6d3586这样的输出。这其实不是乱码，而是Java默认的数组toString()实现方式。让我们拆解这个现象：

java复制int[] numbers = {1, 2, 3};
System.out.println(numbers);  // 输出类似 [I@1b6d3586

这段输出由三部分组成：

• [ 表示这是一个数组
• I 表示数组元素类型是int
• @1b6d3586 是数组对象的哈希码十六进制表示

1.1 Java对象打印的底层机制

Java中所有类都继承自Object类，而Object类的toString()方法默认实现就是"类名@哈希码"。数组虽然是特殊对象，但也遵循这个规则。这就是为什么直接打印数组得不到我们期望的元素列表。

关键点：直接打印对象时，Java会调用该对象的toString()方法。如果没有重写，就会使用Object类的默认实现。

1.2 数组与集合的打印差异

对比集合类的打印行为：

java复制List<Integer> list = Arrays.asList(1, 2, 3);
System.out.println(list);  // 输出 [1, 2, 3]

集合类如ArrayList已经重写了toString()方法，会递归调用每个元素的toString()。这就是为什么集合打印出来更友好。

2. 正确打印数组的5种方法

2.1 使用Arrays.toString()

这是最常用的数组打印方式：

java复制int[] arr = {1, 2, 3};
System.out.println(Arrays.toString(arr));  // 输出 [1, 2, 3]

对于多维数组，需要使用Arrays.deepToString()：

java复制int[][] matrix = {{1, 2}, {3, 4}};
System.out.println(Arrays.deepToString(matrix));  // 输出 [[1, 2], [3, 4]]

2.2 手动遍历打印

当需要自定义格式时，可以手动遍历：

java复制for (int i = 0; i < arr.length; i++) {
    System.out.print(arr[i] + " ");
}
// 输出：1 2 3 

2.3 使用Java 8的Stream API

java复制Arrays.stream(arr).forEach(e -> System.out.print(e + " "));
// 或者
System.out.println(Arrays.stream(arr).mapToObj(String::valueOf).collect(Collectors.joining(", ", "[", "]")));

2.4 使用第三方库

比如Apache Commons Lang的ArrayUtils：

java复制System.out.println(ArrayUtils.toString(arr));

2.5 重写toString()方法（自定义类数组）

对于自定义类的数组，可以重写类的toString()：

java复制class Person {
    String name;
    // ...构造方法等...
    
    @Override
    public String toString() {
        return "Person{" + name + "}";
    }
}

Person[] people = {...};
System.out.println(Arrays.toString(people));  // 会调用每个Person的toString()

3. 集合类的打印规则解析

集合类如ArrayList、HashSet等都已经重写了toString()方法，打印时会显示实际内容：

java复制List<String> list = new ArrayList<>();
list.add("A");
list.add("B");
System.out.println(list);  // 输出 [A, B]

3.1 不同集合类型的打印特点

• List：保留插入顺序，用逗号分隔，方括号包裹
• Set：不保证顺序（HashSet），TreeSet会排序
• Map：大括号包裹，键值对用等号连接

java复制Map<String, Integer> map = new HashMap<>();
map.put("a", 1);
System.out.println(map);  // 输出 {a=1}

3.2 自定义集合打印

可以通过重写集合元素的toString()方法，或者使用Stream API自定义输出格式：

java复制list.stream()
    .map(s -> "Item: " + s)
    .forEach(System.out::println);

4. 常见问题排查与性能考量

4.1 打印数组时的典型问题

1. 空指针异常：

   java复制int[] arr = null;
   System.out.println(Arrays.toString(arr));  // 抛出NullPointerException
   

2. 多维数组打印不完整：

   java复制int[][] arr = {{1, 2}, {3, 4}};
   System.out.println(Arrays.toString(arr));  // 输出[[I@1b6d3586, [I@4554617c]
   

   正确做法是使用Arrays.deepToString()

3. 自定义对象数组未重写toString()：

   java复制Person[] people = {...};  // Person未重写toString()
   System.out.println(Arrays.toString(people));  // 输出全限定类名@哈希码
   

4.2 性能对比

在大数据量下，不同打印方式性能差异明显：

生产环境中，对于大型数组建议分批处理或使用StringBuilder手动构建输出。

5. 最佳实践与实用技巧

1. 日志打印优化：

   java复制log.debug("Current array: {}", Arrays.toString(arr));  // 使用占位符避免不必要的toString()调用
   

2. 调试时快速查看数组：

   • IDEA/Eclipse调试模式下可以直接查看数组内容
   • 或者使用Arrays.copyOfRange()打印部分内容

3. 自定义分隔符：

   java复制String joined = String.join(" | ", Arrays.stream(arr).mapToObj(String::valueOf).toArray(String[]::new));
   

4. 重写toString()的注意事项：

   • 包含足够的信息
   • 避免循环引用
   • 考虑性能影响

5. Java 16+的新特性：

   java复制System.out.println(Arrays.toString(arr).replace(", ", "\t"));  // 用制表符替代逗号
   

对于Java开发者来说，理解数组和集合的打印规则不仅是解决"乱码"问题的关键，更是深入理解Java对象体系的重要入口。实际编码中，根据场景选择最适合的打印方式，可以显著提升开发效率和代码可读性。