Java数组length是public final字段,非方法故不可加括号;多维数组中仅返回第一维长度;访问前必须判空以防NullPointerException。

Java 数组的 length 属性看似简单,但在大型系统中,误用或忽略细节极易引发空指针、越界、逻辑错乱甚至线上故障。它不是方法,不能加括号;不是集合的 size(),不能混用;也不是可变字段,不能赋值。真正用好它,关键在三点:写法正确、访问安全、语义清晰。
length 是字段,不是方法——写法错误直接编译失败
这是最常踩的坑。数组的 length 是 JVM 内置的 public final 字段,不是任何类定义的方法,因此调用时绝不可加括号。
-
✅ 正确写法:
int len = arr.length;(无括号) -
❌ 编译报错:
int len = arr.length();→ 提示Cannot resolve method 'length()' -
❌ 类型混淆:
list.length(List没有length字段)、str.length(字符串要用length()方法)
多维数组的 length 只反映第一维——别假设“矩阵规整”
在处理表格、图像像素、JSON 解析后的嵌套结构等场景时,matrix.length 返回的是“行数”,而非总元素数或列数。尤其当数据来自外部(如 API 响应),很可能出现“不规则数组”(ragged array)。
OpenJDK 24 Windows x64 官方参考实现(24+36),适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。
-
int[][] data = {{1}, {2, 3, 4}, {5, 6}};→data.length == 3,但data[0].length == 1,data[1].length == 3 - 遍历时外层用
i < data.length,内层必须用j < data[i].length,且需确保data[i] != null - 切忌写成
for (int j = 0; j < data[0].length; j++)—— 第二行若为空或长度不同,会出错
访问前必须判空——null 数组是 NPE 的高发源头
数组没有 isEmpty() 或 isNotNull() 封装,arr.length 一旦作用于 null,立刻抛 NullPointerException。这在微服务间 JSON 反序列化、DAO 层返回值、配置项缺失等场景极为常见。
立即学习“Java免费学习笔记(深入)”;
-
✅ 安全写法:
if (arr != null && arr.length > 0) { ... } -
❌ 危险写法:
if (arr.length > 0) { ... }(arr == null时崩溃) - 方法参数标注
@NonNull仅是提示,运行时仍需校验;DTO 中数组字段默认可能为null,而非空数组
length 固定且只读——扩容必须新建数组
数组创建后,length 就锁定在对象头中,不可修改。试图赋值(如 arr.length = 10)会编译失败。大型系统中高频扩容操作应避免裸数组,改用集合;若必须用数组,应封装工具逻辑。
-
int[] old = {1, 2};→ 扩容需int[] expanded = Arrays.copyOf(old, 8); - 不要手动
new int[新长度]+System.arraycopy,除非性能敏感且已 profiling 确认瓶颈 - 缓存
arr.length变量(如final int n = arr.length;)可读性更好,但非必须——JVM 对length读取做了零开销优化

















