Java 调试展示技巧：Arrays.toString 实战

先说一个很常见的坑：直接用 System.out.println(arr) 打印数组，出来的结果就是 [Lja va.lang.String;@1b6d3586 这种哈希值，完全看不出里面装了什么。真正让调试变得高效的工具，是 Arrays.toString(arr)——专为“一眼看清数组”设计。

一维数组：用 Arrays.toString() 就够了

它自动处理所有基本类型（int[]、char[]、boolean[] 等）和引用类型（String[]、User[]），格式统一、安全可靠：

• 元素间用逗号加空格分隔，整体包在方括号里，例如 [1, 2, 3] 或 [a, b, c]
• 数组为 null 时返回字符串 "null"，不抛异常
• 元素含 null（如 new String[]{null, "ok"}）会如实显示为 [null, ok]
• 自定义对象需重写 toString()，否则仍显示 ClassName@hash

二维及以上数组：必须换 Arrays.deepToString()

Arrays.toString() 对多维数组无效——它只展开第一层，内部仍是地址。要真正看清嵌套结构，得用 Arrays.deepToString()：

• 递归处理每一层子数组，输出如 [[1, 2], [3, 4, 5]] 或 [[x], [y, z]]
• 支持混合类型，例如 Object[] mixed = {"a", new int[]{1,2}, new String[]{"x"}} → [a, [1, 2], [x]]
• 传入 null 会直接抛 NullPointerException，建议先判空：arr == null ? "null" : Arrays.deepToString(arr)

日志与调试中的实用习惯

光会调用还不够，结合场景才能避免踩坑、提升效率：

• 在日志中优先用占位符写法：log.debug("items = {}", Arrays.toString(items))，避免字符串提前拼接
• 大数组防刷屏：Arrays.toString(Arrays.copyOf(arr, Math.min(10, arr.length))) 截取前若干项
• 加上下文标签：System.out.println("config keys = " + Arrays.toString(keys))，方便快速定位
• 配合断点时，IDE 变量窗虽能展开，但 console 输出更稳定——尤其对已出作用域的局部变量

不是万能的：哪些情况不该硬套

Arrays.toString() 和 deepToString() 是调试利器，但有明确边界：

• 不处理敏感数据（如密码、token），打印前应脱敏或跳过
• 不适用于百万级大数组，可能卡顿或撑爆日志；此时建议抽样或统计摘要
• 不能替代序列化——它不保存类型、不可反解析，真要持久化或传输，请用 JSON（Gson/Jackson）或标准序列化机制
• 对自定义对象内部的数组字段（如 Person.scores），deepToString 不自动穿透；需在 Person.toString() 中手动调用