arrays.deeptostring()是调试嵌套数组最直接的工具，专用于递归展开多维原始数组、含子数组的对象数组及泛型集合转数组后的结构，能快速暴露空值、维度错位等问题，但不处理null输入、自循环引用、未重写tostring()的自定义对象，也不适用于json格式化或高频日志场景。
Arrays.deepToString() 是 Java 调试嵌套数组最直接、最轻量的工具，专为“看清楚结构”而生——它不改数据、不依赖框架、一行代码就能递归展开所有数组层级，快速暴露空值、维度错位、类型不匹配等映射问题。
哪些结构必须用 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<int></int>不能直接传入，但list.toArray()得到Object[]，即可安全调用
调试时怎么避免踩坑？
几个高频出错点，提前处理更省时间：
- 传入
null会直接抛NullPointerException，建议统一加判空：arr == null ? "null" : Arrays.deepToString(arr) - 数组内部有自循环引用（比如
arr[0] = arr），会导致栈溢出，调试时注意检查构造逻辑 - 自定义对象未重写
toString()，仍显示ClassName@hash——deepToString 不穿透对象字段，只负责数组层 - 忘记
import 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()或序列化工具
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
