java通用集合打印工具类通过泛型重载支持list、set、map和数组，提供统一入口print(object)自动分发，安全处理null、循环引用及嵌套结构，用string.valueof()防npe，不足100行且零依赖。
Java 中编写通用集合打印工具类，核心是利用泛型和重载支持多种集合类型，同时兼顾可读性和安全性（如空值、循环引用处理）。不需要依赖第三方库，用标准 JDK 就能实现简洁实用的工具。
支持常见集合类型的重载方法
针对 List、Set、Map 和数组提供独立方法，避免类型擦除带来的判断困难，也提升调用时的语义清晰度：
-
print(List> list)：格式化输出带索引的列表，如[0] apple, [1] banana -
print(Set> set)：按自然顺序或插入顺序（如 LinkedHashSet）输出，不带索引 -
print(Map, ?> map)：以key=value形式逐行打印，键值对对齐更易读 -
print(Object[] array)：兼容基本类型数组（通过Arrays.toString()自动适配）
统一入口 + 泛型兜底处理
提供一个泛型静态方法作为统一入口，自动识别并分发到对应重载方法，同时处理 null 和非集合/数组类型：
public static void print(Object obj) {
if (obj == null) {
System.out.println("null");
return;
}
if (obj instanceof Collection) {
print((Collection>) obj);
} else if (obj instanceof Map) {
print((Map, ?>) obj);
} else if (obj.getClass().isArray()) {
print((Object[]) obj);
} else {
System.out.println(obj);
}
}
这样调用 PrintUtil.print(myList)、PrintUtil.print(myMap) 或 PrintUtil.print("hello") 都能正确响应。
增强可读性与安全性的小技巧
实际使用中容易忽略但很关键的细节：
- 对字符串、数字等简单类型直接
toString()，避免意外调用Object.toString()显示哈希码 - 集合元素为 null 时显示
<null></null>而非抛空指针，提升调试友好性 - 嵌套集合（如
List<list>></list>）会递归调用自身，形成缩进或括号嵌套（可选），避免无限展开 - 不强制要求元素实现
toString()安全，内部用String.valueOf()替代直接调用，防 NPE
轻量无依赖，开箱即用
整个工具类不到 100 行，无需引入 Gson、Apache Commons 等依赖。可直接复制使用，也可按需扩展 JSON 风格输出、限长截断（如只打前 10 项）、颜色高亮（配合 ANSI 转义符）等功能。关键是把“看得清、不报错、少写重复代码”落到实处。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
