Collections.checkedList 是 Java 运行期类型安全包装器，仅在 add、addAll、set 等写操作时动态校验元素类型是否匹配指定 Class<T>，读操作无开销；不修复历史非法数据，不支持泛型嵌套类型。
Collections.checkedList 是 Java 提供的一种运行期类型安全包装器，它能在向 List 添加元素时强制检查泛型类型，防止运行时因类型不匹配导致的 ClassCastException。它的核心作用不是在编译期做检查（那是泛型的职责），而是在**每次调用 add、addAll、set 等修改操作时，动态验证实际传入对象是否属于声明的泛型类型**。
基本用法：包装原始 List 并指定类型
你需要先创建一个原始（非泛型或泛型擦除后）的 List，再用 Collections.checkedList 包装它，并明确传入期望的运行时类型（Class<T>）：
- 被包装的 list 可以是任意实现类，如
ArrayList、LinkedList，甚至未加泛型的 raw list - 第二个参数必须是具体类型字节码，例如
String.class、Integer.class，不能是类型变量或通配符 - 返回的是一个受检的
List<T>视图，所有写操作都会触发类型校验
示例：
List<String> safeList = Collections.checkedList(new ArrayList<>(), String.class);safeList.add("hello"); // ✅ 允许
safeList.add(123); // ❌ 抛出 ClassCastException
只对写操作生效，读操作无额外检查
checkedList 不改变底层数据结构，也不对已有元素做遍历校验。它仅在插入、替换、批量添加等修改行为发生时检查新值类型：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
-
get(i)、size()、iterator()等只读方法完全不干预，性能无损耗 - 如果 list 在被包装前就混入了非法类型（比如用 raw list 添加过
Integer），那么后续get()取出时仍可能抛出ClassCastException—— checkedList 不修复历史数据 - 因此推荐：从一开始就用
checkedList包装空集合，避免“带病入组”
注意泛型擦除与类型边界限制
由于 JVM 泛型擦除，checkedList 实际依赖 Class 对象做 isInstance 判断，因此有几点关键约束：
- 不能用于带泛型参数的类型，如
List<List<String>>.class编译不通过；只能传List.class这种原始类型，失去嵌套信息 - 对于泛型类（如自定义
class Box<T>），只能检查是否为Box.class，无法校验其类型参数T - 支持继承关系：若声明为
Number.class，则允许添加Integer、Double等子类实例
替代方案与使用建议
checkedList 是一种轻量级防御性工具，适合在不可控输入场景中增加一层保障，但不应替代正确的泛型设计：
- 优先使用强类型泛型 + 编译期检查；
checkedList是兜底，不是首选 - 不要对频繁写入的 list 使用它——每次 add 都有一次
Class.isInstance调用，有微小开销 - 若需更严格的容器约束（如限定元素唯一性、范围、格式），考虑封装自定义 list 或使用 Guava 的
ImmutableList/Constraints.constrainedList - 注意它返回的是包装视图，原 list 仍可绕过检查直接操作 —— 应弃用原始引用，只暴露 checked 版本
