最常用且推荐的方式是增强for循环配合System.out.println或SLF4J等日志工具；需清晰标识元素、索引及集合状态，避免并发问题和性能损耗，生产环境优先使用可分级控制的日志框架。
在 Java 中迭代集合时打印调试信息，最常用且推荐的方式是使用增强 for 循环（for-each）配合 System.out.println() 或更规范的日志工具（如 SLF4J + Logback）。关键是要清晰标识当前元素、索引（如需）、集合状态，避免干扰正常逻辑或引发并发问题。
用增强 for 循环 + println 打印基础信息
适合快速验证数据内容，无需索引时简洁直接：
for (String item : list) {
System.out.println("DEBUG - item = " + item);
}如果想同时显示序号，可手动维护一个计数器：
int index = 0;
for (String item : list) {
System.out.println("DEBUG[" + index++ + "] = " + item);
}用传统 for 循环打印带索引的详细信息
当需要精确控制、访问前后元素或处理数组/ArrayList 等支持随机访问的集合时更合适：
立即学习“Java免费学习笔记（深入）”；
- 适用于
ArrayList、String[]等支持get(i)或下标访问的结构 - 可安全打印索引、元素值、集合大小等上下文
- 示例：
for (int i = 0; i < list.size(); i++) {
System.out.printf("DEBUG[%d/%d] -> %s%n", i, list.size(), list.get(i));
}用迭代器（Iterator）兼顾安全与调试灵活性
适用于可能在遍历中修改集合（如删除元素），或需要检查 hasNext() 状态的场景：
- 避免
ConcurrentModificationException（仅限单线程调用remove()） - 可打印当前游标位置（需自行计数）
- 示例：
Iterator<String> it = list.iterator();
int i = 0;
while (it.hasNext()) {
String item = it.next();
System.out.println("DEBUG(iter)[" + i++ + "] = " + item);
// it.remove(); // 如需安全删除，放在这里
}用日志框架替代 println（生产推荐）
避免在正式环境留下调试输出，也便于分级、过滤和定位：
- 使用 SLF4J（桥接 Logback 或 Log4j2）：
- 启用 debug 级别日志，只在开发/测试环境输出
- 示例（Lombok + SLF4J）：
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
<p>public class Example {
private static final Logger log = LoggerFactory.getLogger(Example.class);</p><pre class="brush:php;toolbar:false;">public void debugList(List<String> items) {
for (int i = 0; i < items.size(); i++) {
log.debug("Item[{} of {}]: {}", i, items.size(), items.get(i));
}
}}
启动时加 JVM 参数 -Dlogging.level.com.yourpackage=DEBUG 即可开启。
不复杂但容易忽略：避免在循环内拼接大量字符串（尤其用 +），大集合下影响性能；优先用 printf 或日志的占位符（如 log.debug("item: {}", item)）实现延迟格式化。
