Arrays.toString 格式化输出数组数据与自定义展示效果指南

在 Ja va 日常开发中，数组的格式化输出算是高频需求之一。Arrays.toString() 虽然是最直接的工具，但它只负责“标准格式”，并不提供自定义能力。想让输出更贴合实际场景——比如去掉空格、换分隔符、加前缀后缀，甚至适配多维或自定义对象——就得先搞清楚它的能力边界，以及遇到不够用时该怎么补足。

一维数组：用 Arrays.toString() 快速调试

这是它的主战场，一行代码就能把数组变成可读字符串。它对 int[]、String[]、boolean[] 等所有一维基本类型和引用类型数组都有效，自动包裹方括号 [ ]，元素间用 , （逗号加空格）分隔。null 元素会显示为字面量 null，不会报错；如果传入的数组本身就是 null，则返回字符串 "null"。需要特别注意的是，这个方法必须通过 ja va.util.Arrays 调用，不能写成 arr.toString()——后者对数组来说基本是无效的。

多维数组：别用 toString，改用 deepToString

不少新手在这里栽过跟头：Arrays.toString() 对二维及以上数组完全无效，它只展开第一层，子数组仍然显示为类似 [I@1b6d3586 的哈希值。正确的做法是改用 Arrays.deepToString()，它会递归调用每一层子数组的 toString()，输出形如 [[1, 2], [3, 4]] 这种清晰的结构。这个方法同样能安全处理 null 元素和 null 子数组，但需要注意：如果遇到循环引用（比如子数组相互引用），会抛出 StackOverflowError。

自定义对象数组：重写 toString() 才有意义

如果不重写 toString()，Arrays.toString() 只会输出 MyClass@xxxx 这类毫无意义的信息。核心做法是在自定义类中用 @Override 显式重写 toString() 方法，返回简洁、字段明确的字符串，例如 Person{name='Alice', age=30}。这里需要留意几点：确保方法不返回 null、不抛异常，尤其要注意字段可能为 null 的情况。对于二维对象数组，仍然需要搭配 Arrays.deepToString() 才能正确递归展开。

需要自定义格式？这几个替代方案更灵活

当你需要把逗号换成竖线、去掉空格、加引号，或者跳过 null 元素时，Arrays.toString() 就明显不够用了。这时候可以考虑几种替代方案：StringJoiner 适合简单定制，可以设置分隔符、前缀（如 "["）、后缀（如 "]"），空数组自动返回 "[]"；Stream + joining 支持链式映射，比如把数字转成十六进制再拼接：mapToObj(x -> String.format("0x%02X", x))；如果对边界逻辑有特殊要求，StringBuilder 手动拼接 则在性能和灵活性上更有优势。选择哪一种，取决于你具体想控制到什么程度。