在Java嵌套数组调试中，Arrays.deepToString()堪称“第一把交椅”。它无需依赖外部框架，不修改原始数据，仅需一行代码即可递归展开所有数组层级，快速暴露空值、维度错位、类型不匹配等问题。不过它也存在一些局限：传入null会抛出NullPointerException，自循环引用将导致栈溢出，若自定义对象未重写toString()则只能显示类名加哈希码，更不能用于JSON格式化或高频日志场景。
简而言之，Arrays.deepToString() 专为“看清数组结构”设计——无需修改数据、不依赖第三方框架，一行代码递归展开所有层级，让空值、维度错位、类型不匹配等问题瞬间暴露。
哪些结构必须用 deepToString？
它只对“数组类型”生效，而且必须是真正含嵌套的结构：
- 多维原始数组：比如
int[][]、double[][][]，直接使用 toString() 只会输出哈希码，而 deepToString 则能清晰地打印出[[1, 2], [3, 4, 5]]这样的结构，一目了然。 - 对象数组中含子数组：例如
Object[] mixed = {"a", new int[]{1,2}, new String[]{"x"}}，deepToString 会自动展开为[a, [1, 2], [x]]，无需手动递归。 - 泛型集合转数组后观察：对于
List无法直接传入 deepToString，但通过list.toArray()转为Object[]后即可安全调用，清晰查看内部元素。
调试时怎么避免踩坑？
几个高频出错点，提前处理能省不少时间：
- 直接传入
null将抛出 NullPointerException，建议统一添加判空处理：arr == null ? "null" : Arrays.deepToString(arr)。 - 若数组内部存在自循环引用（例如
arr[0] = arr），会引发栈溢出，调试时需特别检查数组构造逻辑。 - 自定义对象未重写
toString()，deepToString 仍显示ClassName@hash——它仅负责数组层级展开，不穿透对象内部字段。 - 忘记导入
java.util.Arrays会导致编译报错，IDE 通常有红标提示，命令行环境则需手动补全导入语句。
让输出更实用的小技巧
不靠第三方库，也能提升可读性：
- 添加上下文标签：
System.out.println("请求参数 grid: " + Arrays.deepToString(grid));便于追踪输出来源。 - 大数组防刷屏：利用
Arrays.copyOf(arr, Math.min(5, arr.length))截取前几行再打印，避免输出过多。 - 配合断言验证：使用
Assert.assertTrue(Arrays.deepEquals(expected, actual));比直接字符串比较更可靠。 - 定位空值源头：输出中显式显示的
null（例如[[null, "ok"], ["err", null]]）能快速锁定缺失字段的位置。
什么时候不该用它？
它不是万能格式化器，边界要清晰：
- 需要查看对象内部字段（例如
Person.scores为int[]）时，deepToString 不会自动展开——必须在Person.toString()中手动调用Arrays.toString(scores)。 - 如果需要 JSON 格式输出、附带字段名或支持浏览器预览，
new Gson().toJson(arr)或ObjectMapper.writeValueAsString()更为合适。 - 在高频日志场景（比如每毫秒一次）中，递归遍历会产生轻微性能开销，建议仅用于调试分支，上线前移除。
- 对于 Map、Set 等非数组集合，deepToString 不会做特殊处理——虽然可以通过
map.entrySet().toArray()临时辅助查看，但不如直接使用map.toString()或序列化工具。
