java泛型最佳实践是什么

Java 泛型（Generics）自 Java 5 引入，用于提供编译期类型安全和代码复用。下面从设计、使用、性能、常见陷阱四个维度总结Java 泛型最佳实践。

一、设计层面的泛型最佳实践

1. 优先使用泛型而不是 Object

❌ 不推荐

List list = new ArrayList();
list.add("abc");
String s = (String) list.get(0);

✅ 推荐

List<String> list = new ArrayList<>();
list.add("abc");
String s = list.get(0);

好处：编译期检查，避免 ClassCastException

2. 泛型命名要语义化（不要只用 T）

常见约定：

• T：Type
• E：Element（集合）
• K：Key
• V：Value
• N：Number
• R：Result

✅ 推荐

public interface Repository<K, V> {
    V find(K key);
}

3. 使用有界泛型（Bounded Generics）

当泛型需要约束能力时，使用 extends

✅ 推荐

public <T extends Comparable<T>> T max(T a, T b) {
    return a.compareTo(b) > 0 ? a : b;
}

❌ 避免无限制泛型（除非真的需要）

public <T> void process(T t) { } // 通常意义不大

4. 优先使用泛型方法而不是泛型类

如果只有某个方法需要泛型，不要污染整个类

✅ 推荐

public class Utils {
    public static <T> T getFirst(List<T> list) {
        return list.get(0);
    }
}

二、使用层面的泛型最佳实践

5. 使用 <? extends T>（Producer）和 <? super T>（Consumer）

遵循 PECS 原则（Producer Extends, Consumer Super）

✅ 读取（Producer）

void read(List<? extends Number> list) {
    Number n = list.get(0);
}

✅ 写入（Consumer）

void write(List<? super Integer> list) {
    list.add(1);
}

6. 不要用原始类型（Raw Type）

❌ 禁止

List list = new ArrayList();

✅ 明确类型

List<String> list = new ArrayList<>();

7. 使用菱形操作符 <>（Java 7+）

✅ 推荐

List<String> list = new ArrayList<>();

8. 避免在 API 中暴露泛型实现细节

❌ 暴露

public Map<String, List<User>> getUserMap() {
    return new HashMap<>();
}

✅ 封装（可选）

public UserRepository getUserRepository() {
    return new UserRepository();
}

三、性能与类型安全最佳实践

9. 理解泛型擦除（Type Erasure）

• 泛型只在编译期存在
• 运行时 List<String> → List

⚠️ 不能做：

if (obj instanceof List<String>) // 编译错误

✅ 正确

if (obj instanceof List) {
    List<?> list = (List<?>) obj;
}

10. 避免在泛型中使用数组

❌ 错误示例

T[] array = new T[10]; // 编译错误

✅ 替代方案

List<T> list = new ArrayList<>();

或

@SuppressWarnings("unchecked")
T[] array = (T[]) new Object[10];

四、常见陷阱与错误用法

11. 不要滥用 <?>

❌ 错误

List<?> list = new ArrayList<String>();
list.add("x"); // 编译错误

✅ 明确边界

List<? super String> list = new ArrayList<>();
list.add("x");

12. 静态字段不能使用泛型类参数

❌ 错误

class Box<T> {
    static T value; // 编译错误
}

✅ 使用泛型方法

static <T> T getValue() { ... }

13. 异常不能使用泛型

❌ 错误

class MyException<T> extends Exception { } // 不允许

五、总结速查表 ✅

如果你愿意，我也可以：

• 结合 Spring / JPA / 集合框架 讲泛型实战
• 对比 Java vs Kotlin 泛型
• 深入讲 泛型擦除与反射

你更想看哪一块？