泛型类支持多个类型参数，用于建模键与值、输入与输出等不相关类型关系；常见组合如K/V、T/E、Input/Output，需职责分明、字段与方法严格对应各参数。
泛型类支持多个类型参数，本质是把“类型”也当作可配置的变量来使用。当业务逻辑涉及两个或以上不相关、不可互相替代的类型（比如键与值、输入与输出、ID 与数据实体），单个类型参数就不够用了——这时用 T, V 或 K, V 这样的多参数结构，才能准确建模真实关系。
明确每个参数的职责，避免类型混用
多个类型参数不是越多越好，关键在语义清晰。常见分工模式有：
-
K 和 V：专用于键值映射场景，如
Map<string integer></string>或自定义缓存容器Cache<string user></string> -
T 和 E：T 表示主数据类型，E 表示异常/事件/扩展类型，例如日志处理器
Logger<request validationerror></request> -
Input 和 Output：强调转换关系，如数据管道
Pipeline<json user></json>，表示输入是 JSON 字符串，输出是 User 实例
构造函数与字段需严格对应类型参数
声明了两个类型参数，就要在类中为它们各自分配独立字段，不能共用一个泛型占位符。错误写法：private T data;（只用了 T，V 被忽略）；正确写法：
public class Pair<K, V> {<br> private final K key;<br> private final V value;<br> public Pair(K key, V value) {<br> this.key = key;<br> this.value = value;<br> }<br>}
这样在实例化时 new Pair<integer string>(100, "active")</integer>，key 和 value 的类型就完全解耦、各自独立。
方法签名要复用对应类型，不强行统一
泛型类中的方法，如果操作的是 K 类型对象，参数和返回值就该用 K；如果是 V，就用 V。不要为了“简洁”而把两者都改成 T：
- ✅ 支持不同行为：
public K getKey() { return key; }和public void setValue(V newValue) { this.value = newValue; } - ❌ 破坏类型契约：
public T getBoth() { ... }（T 无法同时代表 K 和 V）
这种分离让 IDE 能精准推导类型，调用方也能获得完整的编译期检查。
实际组合场景：带状态的数据容器
一个典型需求：封装某个 ID（字符串）、原始数据（任意类型）、处理状态（枚举）。三者类型完全不同，且缺一不可：
Java 示例：public class DataUnit<ID, DATA, STATUS> {<br> private final ID id;<br> private DATA payload;<br> private STATUS status;<br> public DataUnit(ID id, DATA payload, STATUS status) {<br> this.id = id;<br> this.payload = payload;<br> this.status = status;<br> }<br>}
使用时：new DataUnit<string order processingstate>("ORD-001", orderObj, ProcessingState.DONE)</string>。三个类型参数各司其职，逻辑组合自然、无歧义。
