Java泛型规范建模核心是明确类型意图、边界可控、复用安全，需按语义命名类型参数（如E、K/V、DTO/REQ/RESP），合理使用extends限定上界，优先接口与泛型方法，慎用通配符与原始类型，并规避类型擦除陷阱。
Java 泛型在实际项目中规范建模，核心是让类型意图清晰、边界可控、复用安全，而不是堆砌语法。关键不在“能不能用”，而在“为什么这么用”。
明确泛型角色，按场景选命名与约束
类型参数不是占位符，而是有语义的契约。避免全用 T，优先按约定使用：
-
E：用于集合元素（如
List<E>、Queue<E>） -
K/V：用于键值对结构（如
Map<K, V>、Cache<K, V>） -
DTO/REQ/RESP：业务层泛型类可采用语义化名称（如
Result<OrderResp>），比Result<T>更易读 - 需要限定范围时，必须加 extends 上界（如
<T extends Serializable & Cloneable>），不写则默认为Object，失去约束力
接口优先于类，方法优先于接口
泛型建模应从抽象出发，逐级收敛：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 定义泛型接口（如
Repository<T, ID>），让实现类决定具体类型，而非在基类里硬编码 - 工具类中多用泛型方法（如
public static <T> List<T> filter(List<T> src, Predicate<T> p)），避免为单次逻辑创建泛型类 - 避免泛型类继承非泛型父类，或非泛型类继承泛型子类——容易破坏类型一致性
谨慎处理通配符与原始类型
通配符不是“偷懒写法”，而是明确表达协变/逆变意图：
立即学习“Java免费学习笔记（深入）”；
- 只读场景用
Collection<? extends Number>（上界），确保能安全取值 - 只写场景用
List<? super Integer>（下界），确保能安全存入子类型 - 绝对不用原始类型（如
ArrayList），它等价于ArrayList<Object>，会绕过所有泛型检查 - 日志、监控等跨层组件接收泛型对象时，统一转为
Object或提取关键字段，不保留泛型上下文
规避类型擦除引发的实践陷阱
编译后泛型信息消失，这决定了某些操作不可行，需提前设计替代方案：
- 不声明
new T[10]—— 改用ArrayList<T>或通过Class<T>参数构造数组 - 不在运行时用
instanceof判断泛型类型（如list instanceof List<String>无效）—— 改用元素实例判断或额外传入Class<T> - 序列化/反序列化泛型对象时，显式传入
TypeReference（如 Jackson 的new TypeReference<List<User>>() {}），否则类型信息丢失
