应通过方法重载统一处理多种输入形态：支持Collection<String>、String[]、String等，优先接收接口而非具体实现，避免泛型擦除冲突，最终归一化为Iterator<String>处理，并明确null语义。
直接用集合配合方法重载做兼容处理，本质不是“把集合当参数传进去”，而是让工具类能自然接纳不同形态的输入（比如 List、Set、数组、甚至单个元素），再统一归一化为标准处理流程。关键不在集合本身，而在重载如何覆盖常见容器类型，并避免歧义。
覆盖主流集合接口，不绑定具体实现
工具类应优先接受接口而非具体类，保证扩展性：
-
parse(Collection<String> items)—— 兼容ArrayList、LinkedHashSet、Arrays.asList()等所有标准集合 -
parse(String[] items)—— 覆盖数组场景，内部转为Arrays.asList(items)后复用 Collection 版本 -
parse(String item)—— 单个字符串视为长度为 1 的逻辑集合，避免调用方手动包装 - 不提供
parse(ArrayList<String>)或parse(LinkedList<String>)这类具体类型重载，否则会引发泛型擦除冲突或冗余分支
处理泛型擦除带来的重载陷阱
Java 泛型在运行时被擦除，所以以下写法编译不通过：
-
void handle(List<String> list)和void handle(List<Integer> list)—— 擦除后都是handle(List)，构成重复定义 - 正确做法是用类型区分：例如
handle(List<?> list)+ 类型检查，或改用更上层的接口如Iterable<T> - 若需支持多种元素类型，可设计为
<T> void parse(Iterable<T> source, Function<T, String> mapper)，靠泛型方法+函数式参数解耦
与流包装策略协同，统一入口
集合只是输入形态之一，要和文件、字节、路径等其他来源保持行为一致：
- 所有重载最终都导向同一核心方法，例如
doProcess(Iterator<String> iter) -
parse(Collection<String> c)→c.iterator() -
parse(String[] a)→Arrays.stream(a).iterator() -
parse(Path p)→Files.lines(p).iterator() - 这样既复用逻辑，又确保空集合、null 安全、资源释放等统一管控
规避常见歧义和误用
重载组合不当容易让编译器无法抉择：
- 避免同时存在
parse(Collection<String>)和parse(Object... items)：传parse("a", "b")会匹配可变参数，但parse(Arrays.asList("a","b"))又走集合版，语义割裂 - 若必须支持可变参数，建议命名区分：
parseAll(String... items)明确表达“多个独立项”，而parse(Collection<String>)表达“已有集合结构” - null 值需明确定义：集合重载中，
parse((Collection<String>) null)应抛NullPointerException，而非静默跳过；单个parse((String) null)可按业务决定是否允许
