Java中不能直接创建泛型数组T[]，因类型擦除导致JVM无法识别T；应优先用ArrayList替代，必须用数组时传Class<T>配合Array.newInstance，或封装Object[]并严格校验。
Java 中不能直接写 T[] arr = new T[10]，因为泛型在运行时被擦除，JVM 不知道 T 是什么类型，无法创建真正带组件类型的数组。编译器会报错或警告，比如 “Unchecked cast from Object[] to T[]”。解决的关键不是强行压制警告，而是选对方式——让类型安全可验证、风险可控、代码易维护。
优先用 ArrayList 替代泛型数组
绝大多数业务场景根本不需要泛型数组。ArrayList 内部已封装好 Object 数组 + 类型检查逻辑，完全类型安全，且 API 清晰：
- 声明：
private final List<T> data = new ArrayList<>(); - 增删查改都走泛型方法，不会出现
ClassCastException - 如需数组视图，调用
data.toArray(new T[0])（JDK 11+ 推荐），底层会自动用反射生成正确类型的数组
必须用数组时：传 Class 对象 + Array.newInstance
当要对接 JNI、反射 API 或第三方库要求明确的 T[] 类型时，靠 Object[] 转换不够用。此时应显式传入 Class<T>，用反射创建真实类型数组：
- 构造时接收
Class<T> type参数 - 创建数组：
T[] array = (T[]) Array.newInstance(type, size); - 该数组运行时类型就是
T[]，存入非T实例会立即抛ArrayStoreException（比ClassCastException更早暴露问题） - 注意：基本类型不支持（如
int.class不能用于创建int[]），只能用包装类
用 Object[] 底层 + 封装校验（慎用但常见）
如果已有老代码或性能敏感场景需保留数组结构，可用 Object[] 作存储，但必须严格封装：
立即学习“Java免费学习笔记（深入）”；
- 字段声明为
private Object[] data;，绝不对外暴露引用 - 所有写入入口（如
add(T item)）必须用type.isInstance(item)校验类型 - 读取时强制转换：
@SuppressWarnings("unchecked") T t = (T) data[i];，注解只加在最小作用域（如局部变量） - 禁止提供
getRawArray()这类返回Object[]的方法，否则外部误写会破坏类型安全
避免踩坑的硬性原则
无论选哪种方案，以下三点不能妥协：
- 公共 API 中不接受或返回泛型数组参数（如
<T> void process(T... items)），改用List<T>或明确的Object[] + Class<T> -
@SafeVarargs只能用于static或final方法，且方法体内不能修改或泄漏 varargs 数组 - 不要为了“看起来是泛型数组”而做无意义的转换，比如把
ArrayList转成T[]再转回来——增加复杂度却不提升安全性
