Java泛型通配符是类型占位符，不可实例化或用于返回值推导；正确用法需按读写意图选? extends T（只读）、? super T（只写）或?（无关操作），并避免与泛型方法、instanceof等误混。
Java 泛型通配符作为方法参数传递时，报错通常不是因为“语法写错了”，而是类型约束不匹配、读写操作越界，或误把通配符当具体类型用。核心原则是：通配符不是类型，而是**类型占位符**，它只在声明处（如参数、变量）起作用，不能用于创建对象、返回值类型推导或 instanceof 判断。
一、正确声明通配符参数：明确读/写意图
根据使用场景选对通配符形式，避免编译拒绝：
-
只读数据（比如遍历、统计、校验）→ 用 ? extends T
例如接收 List<String>、List<Integer> 等任意子类型列表：public void printNumbers(List<? extends Number> list) { for (Number n : list) System.out.println(n); }
✅ 允许调用：printNumbers(new ArrayList<Integer>());
❌ 禁止写入：list.add(42);编译失败（类型不确定） -
只写数据（比如收集、填充、归并）→ 用 ? super T
例如向一个能存 Integer 或更宽类型的容器里加元素：public void addIntegers(List<? super Integer> sink) { sink.add(1); sink.add(2); }
✅ 允许传入：addIntegers(new ArrayList<Number>());或new ArrayList<Object>();
❌ 读取只能得 Object：Object o = sink.get(0);（无法安全转成 Integer） -
完全无关操作（比如判空、清空、获取大小）→ 用 ?
public int sizeOf(List<?> list) { return list.size(); }
✅ 安全通用；但不能调用list.get(0).toString()（因为类型未知）
二、别把这些常见写法当“传参”用
以下看似像“传通配符”，实则违反泛型规则，必然报错：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
把通配符当返回类型直接 new：
List<? extends CharSequence> list = new ArrayList<? extends CharSequence>();→ ❌ 编译错误（通配符不可实例化）
✅ 正确写法：List<? extends CharSequence> list = new ArrayList<String>(); -
在方法签名里用通配符做泛型方法的类型参数：
public <T extends ? extends Number> void bad(T t) { ... }→ ❌ 语法非法
✅ 想表达上限，直接写：<T extends Number> -
试图用 instanceof 检查通配符类型：
if (list instanceof List<? extends Runnable>) { ... }→ ❌ 编译失败（运行时擦除，无法判断）
✅ 改用原始类型检查：if (list instanceof List)，再按需做元素类型判断
三、配合泛型方法，让通配符“活起来”
单靠通配符参数只能限制操作，若需在方法内安全地处理具体类型，应搭配泛型方法：
立即学习“Java免费学习笔记（深入）”；
- 错误写法（通配符参数 + 强转）：
void process(List<? extends Number> nums) { Integer i = (Integer) nums.get(0); }→ ❌ 运行时可能 ClassCastException - 推荐写法（泛型方法 + 类型推导）：
<T extends Number> void process(List<T> nums, Class<T> type) { T first = nums.get(0); }
调用：process(intList, Integer.class);→ ✅ 编译期绑定 T，安全可读可写
四、反序列化等运行时场景：通配符救不了类型丢失
JSON 反序列化时写 readValue(json, List.class) 得到的是 ArrayList<LinkedHashMap>，此时即使参数声明为 List<? extends User> 也无济于事 —— 因为运行时根本不是那个类型。
- ✅ 正确做法：用 TypeReference 或 ParameterizedType 显式传入泛型信息
mapper.readValue(json, new TypeReference<List<User>>() {}); - ❌ 不要指望通配符参数自动“修复”反序列化结果的类型
