Java开发实战：Arrays.toString在日志中的应用

Arrays.toString()是Ja va中安全清晰输出数组日志的首选方法，它正确处理null、基本类型和对象数组并避免NPE；对多维数组应使用Arrays.deepToString()。

在Ja va开发里，想把数组内容干净利落地输出到日志中，Arrays.toString() 几乎是绕不开的选择。它自动处理null、基本类型和对象数组，格式简洁且可读性强，关键是能避免意外触发对象的复杂toString逻辑或引发NPE。这一点在实际调试中极为关键——很多新手正是在这里栽了跟头。

为什么不用直接 + "" 或 String.valueOf()？

直接拼接字符串，比如 "" + array，会调用数组的默认 toString()，结果类似于 [Lja va.lang.String;@1b6d3586，完全不可读；String.valueOf(array) 对非null数组同样返回这种哈希形式，只有对null才返回"null"。换句话说，这两种方式都展示不出真实元素，日志也就失去了调试价值。

基本用法：覆盖常见数组类型

Arrays.toString() 支持所有一维数组：字符串、数字、布尔、自定义对象等。如果数组本身为null，它会安全返回"null"，不会抛异常。来看几个典型例子：

• 字符串数组：Arrays.toString(new String[]{"a", "b", "c"}) → [a, b, c]
• int数组：Arrays.toString(new int[]{1, 2, 3}) → [1, 2, 3]
• null数组：Arrays.toString(null) → null
• 含null元素的对象数组：Arrays.toString(new User[]{u1, null, u2}) → [User@123, null, User@456]

嵌套数组？用 Arrays.deepToString()

如果日志对象是二维或多维数组，比如 int[][] 或 String[][]，Arrays.toString() 只会展开第一层，内部仍然是地址。这时候必须换用 Arrays.deepToString()：

• Arrays.toString(new int[][]{{1,2}, {3,4}}) → [[I@abc, [I@def]（毫无意义）
• Arrays.deepToString(new int[][]{{1,2}, {3,4}}) → [[1, 2], [3, 4]]（清晰可读）

日志实践建议

在SLF4J、Log4j等主流日志框架中，推荐将 Arrays.toString() 的结果作为参数传入，避免字符串拼接影响性能：

• 推荐：log.debug("Received IDs: {}", Arrays.toString(ids));
• 不推荐：log.debug("Received IDs: " + Arrays.toString(ids));（提前拼接，浪费GC）
• 若数组可能很大，加长度判断避免刷屏：if (items.length

这件事看起来简单，但确实容易被忽略。一行 Arrays.toString() 就能让日志从"完全看不懂"变成"一眼定位问题"。可以说，这是Ja va开发中性价比最高的调试技巧之一。