Java中二维数组实为“数组的数组”，支持不规则结构；声明如int[][] arr = new int3或int[][] arr = {{1,2},{3,4,5},{6}}；遍历时需判空防NullPointerException。

Java中二维数组的声明与初始化方式

Java里没有真正的“二维数组”，只有“数组的数组”。这意味着第二维长度可以不一致，也决定了初始化必须分步或用花括号语法显式指定结构。

• int[][] arr = new int[3][4]; 创建 3 行 × 4 列的矩形结构，所有元素默认为 0
• int[][] arr = new int[3][]; 只分配第一维（3 个引用），每行需单独初始化，如 arr[0] = new int[2];
• int[][] arr = {{1, 2}, {3, 4, 5}, {6}}; 使用静态初始化，各行长度可不同（不规则数组）

遍历不规则二维数组时的空指针风险

如果只初始化了部分行（比如 new int[3][] 后只赋值了 arr[0] 和 arr[2]），直接用增强 for 或下标访问 arr[1].length 会触发 NullPointerException。

• 安全遍历需先判空：

  for (int i = 0; i < arr.length; i++) {
      if (arr[i] != null) {
          for (int j = 0; j < arr[i].length; j++) {
              System.out.print(arr[i][j] + " ");
          }
      }
  }

• 增强 for 不适合不规则结构：for (int[] row : arr) 可以，但内部再用 for (int x : row) 前仍要检查 row 是否为 null

二维数组作为方法参数传递的常见误区

Java中数组是引用类型，但传递的是引用的副本。修改数组内容（如 arr[i][j] = 99）会影响原数组；但重新赋值整个行（如 arr[i] = new int[]{...}）不会改变调用方的该行引用。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 想让方法能替换某一行，必须返回新数组或用包装类（如 AtomicReference<int></int>）
• 参数声明写成 int[][] data 即可，不需要 int[] data[] —— 后者虽能编译，但属于过时的 C 风格写法，可读性差
• 泛型无法直接约束二维数组类型，List<int></int> 是更灵活的替代方案

性能与内存布局：为什么不要用 Object[][] 存基本类型

用 Object[][] 存 Integer、Double 等包装类，会带来三重开销：装箱/拆箱、对象头内存、GC 压力。而 int[][] 在堆上是连续的原始数据块（每行内连续），访问更快。

立即学习“Java免费学习笔记（深入）”；

• 若需要“可为空”的数值二维结构，优先考虑 int[][] + 特殊哨兵值（如 -1），或用 Optional<integer>[][]</integer>（但代价更高）
• int[][] 的内存占用 ≈ 行数 × (12 + 列数 × 4) 字节（12 是对象头，JVM 实现相关）
• 大量小二维数组（如 10×10）频繁创建时，考虑复用对象池，避免 GC 频繁触发

不规则结构、null 行、装箱陷阱——这三个点在真实项目里最容易漏掉检查，一跑就抛异常或结果错得莫名其妙。