Java工具库优先使用List<T>而非T[]，根本原因是类型安全、泛型兼容性与API一致性：T[]因泛型擦除无法安全构造，易引发ClassCastException，而List<T>由编译器和集合框架保障类型约束，支持可变长度、多态接口及生态统一。
![java中 为什么 guava/apache commons 等开源库优先选择 `list<t>` 而非 `t[]`](https://img.php.cn/upload/article/001/242/473/178417274332976.jpeg)
Java中Guava、Apache Commons等开源库优先使用List<T>而非T[]，根本原因在于类型安全、泛型兼容性与API一致性，而不是性能或内存布局的权衡。
泛型擦除下 T[] 无法安全构造
Java泛型在运行时被擦除，new T[10] 是语法错误。若强行用Object[]转型为T[]（如(T[]) new Object[10]），会触发unchecked警告，且在运行时可能抛出ClassCastException——尤其当方法返回数组并被下游强转时风险极高。而List<T>由JVM和集合框架共同保障类型约束，编译器能静态检查add操作，.get()返回值也自带类型推导。
List<T> 天然支持可变长度与统一接口
- 数组是固定大小、无增删能力的底层结构；
List<T>封装了动态扩容、插入、删除、遍历等语义，符合工具库“开箱即用”的设计目标。 - Guava的
ImmutableList.of()、Commons Collections的CollectionUtils.union()等方法，输入输出都基于Collection/List接口，天然兼容ArrayList、LinkedList甚至第三方集合实现，而T[]只能代表一种具体形态，破坏多态性。
原始类型数组的特殊需求已由专用工具覆盖
有人误以为“数组更快所以该用T[]”，但实际场景中：
- 对原始类型（如
int[]），ArrayUtils（Commons Lang）或Ints.asList()（Guava）提供专门方法，不依赖泛型数组； - 对对象类型，
List<String>比String[]更易组合（如流式处理、null安全操作、空值默认处理）； -
List.of()（Java 9+）、ImmutableList.copyOf()（Guava）内部虽可能用数组存储，但对外完全隐藏实现细节，保证契约稳定。
生态与演进趋势倒逼接口抽象化
Spring、Jackson、Hibernate等主流框架均以Collection为数据交换标准；JUnit断言、Mockito模拟、Lombok生成代码也默认适配List<T>。工具库若暴露T[]，反而增加调用方的转换成本（如list.toArray(new String[0])），违背“减少样板代码”的初衷。
立即学习“Java免费学习笔记（深入）”；
本质上，这不是“数组 vs 列表”的性能之争，而是契约优先的设计选择：List<T>代表行为契约（有序、可迭代、可扩展），T[]仅代表内存布局契约。现代Java工具库要解决的是开发效率与类型安全问题，不是绕过JVM机制去拼底层性能。
