Java多维数组打印技巧

Java 中的 `Arrays.deepToString()` 是专为多维数组设计的递归打印利器，能将嵌套的 `int[][]`、`String[][][]` 或混合类型的 `Object[]` 清晰展开为可读字符串（如 `[[1, 2], [3, 4]]`），彻底告别 `[[I@xxxxxx` 这类毫无意义的哈希乱码；它泛型安全、开箱即用，但需警惕 `null` 输入、循环引用导致的崩溃，以及高频使用时的性能损耗——掌握它的适用边界与替代方案（如 Gson 格式化或 IDE 调试视图），能让 Java 数组调试和日志输出事半功倍。

Arrays.deepToString 是 Java 中专门用于打印多维数组（如二维、三维甚至更高维）的工具方法，它能递归地将嵌套数组转换为可读字符串，避免直接调用 toString() 时出现类似 [[I@1b6d3586 这样的无意义哈希值。

为什么不能直接用 toString()？

Java 数组继承自 Object，其默认 toString() 只返回类名加哈希码，对多维数组完全不展开。例如：

int[][] arr = {{1, 2}, {3, 4}};
System.out.println(arr.toString()); // 输出：[[I@xxxxxx（不可读）

而 deepToString 会逐层解析，输出：[[1, 2], [3, 4]]。

基本用法：支持任意维度和混合类型

该方法是泛型安全的，适用于 Object[] 及其子类型（包括基本类型数组），自动处理嵌套结构：

• 一维数组：行为等同于 Arrays.toString()
• 二维及以上的 int[][]、String[][][]、Object[][] 均可正确展开
• 支持混合嵌套，比如 Object[] 中包含 String[] 和 Integer[]

示例：

Object[] mixed = {new int[]{1, 2}, new String[]{"a", "b"}, "plain"};
System.out.println(Arrays.deepToString(mixed));
// 输出：[[1, 2], [a, b], plain]

常见陷阱与注意事项

使用时需留意以下几点，避免运行时异常或输出不符合预期：

• 传入 null 会抛出 NullPointerException —— 调用前建议判空，或用 Optional 包装
• 循环引用会导致 StackOverflowError —— 若数组 A 中引用了自身或形成环状嵌套，deepToString 会无限递归
• 性能开销略高于普通 toString —— 因为涉及递归遍历，大数据量时慎用于高频日志打印
• 不支持自定义格式化 —— 如缩进、换行、字段名等，如需美化输出需自行封装或借助 Gson/Jackson

替代方案参考（按场景选择）

当 deepToString 不够用时，可考虑：

• 调试阶段：用 IDE 的变量视图（更直观，支持展开/折叠）
• 日志输出：搭配 gson.toJson() 获取 JSON 格式，易读且结构清晰
• 单元测试断言：用 Assert.assertArrayEquals() 比较内容而非字符串
• 自定义打印：封装一个带缩进的递归方法，控制深度和样式

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java多维数组打印技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。