for-each 不能直接遍历二维数组的“所有元素”
Java 的 for-each 语法本质是按「一维可迭代结构」设计的，而 int[][] 这类二维数组在内存中是「数组的数组」——外层数组每个元素是 int[] 类型引用，不是 int。所以写 for (int i : matrix) 会编译报错：类型不匹配。
常见错误现象：incompatible types: int[] cannot be converted to int
- 正确做法是嵌套两层
for-each：外层遍历行（int[]），内层遍历该行的每个int - 如果强行用单层
for-each且变量声明为int[] row，那只是拿到每一行，不是“所有数字” - 性能上无差异，但可读性比传统
for (int i = 0; i 更清晰，前提是别误以为它能扁平化遍历
嵌套 for-each 遍历二维数组的写法和边界注意点
这是最常用、也最安全的写法，适用于 int[][]、String[][] 等所有二维数组类型。
示例：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
int[][] matrix = {{1, 2}, {3, 4, 5}};
for (int[] row : matrix) {
for (int val : row) {
System.out.println(val);
}
}
- 外层
row类型必须与子数组类型一致（如int[]），否则编译失败 - 内层
val类型必须与元素类型一致（如int），不能写成Integer（除非是Integer[][]） - 不需要手动检查
row == null，但如果业务允许空行，就得加判断，否则运行时抛NullPointerException - 不支持反向遍历或带索引访问——需要索引时，老老实实用传统
for循环
想“扁平化”遍历二维数组？别硬套 for-each
有些场景确实需要把二维数组当成一维序列来处理（比如找最大值、统计总和），但 for-each 本身不提供这种能力。
- 不要尝试用
Arrays.stream(matrix).flatMapToInt(...)混合流式操作——这引入了额外开销，且对原始类型二维数组支持差 - 简单任务（如求和）直接嵌套
for-each足够，代码干净，JVM 优化充分 - 如果真要抽象成一维流，得先用
Arrays.stream()转外层数组，再对每行调Arrays.stream(row)，但要注意：原始类型数组（int[]）不能直接转成IntStream再 flatMap，得用Arrays.stream(row).mapToInt(x -> x)，绕且易错 - 兼容性提示：Java 8+ 支持，但 Android 旧版本（API Arrays.stream(int[]) 有兼容问题
三维及以上数组？套路一样，但嵌套层级容易失控
三维数组 int[][][] 就是「数组的数组的数组」，for-each 依然只能一层层剥，没有捷径。
- 三层
for-each是可行的，但可读性明显下降；四层就该怀疑设计是否合理 - 参数差异：每多一维，就要多声明一个中间变量（如
int[][] slice→int[] row→int val），类型必须严格对应 - 容易踩的坑：把
int[][][]的某一层误当成int[]，编译器立刻报错，但初学者常花时间在类型推导上 - 如果维度不固定（比如动态生成的 N 维数组），
for-each完全不适用，必须用递归或反射 +Array.getLength()
