IntelliJ IDEA 2025.1 Java Stream Debugger 快速使用指南

1. 功能概览

Java Stream Debugger 提供 Trace Current Stream Chain 功能，用来在调试时分析和可视化 Stream 操作链。

主要用途：

• 在运行时查看流操作链的每一步输出
• 找出 map/filter 等操作的问题
• 避免手动加 peek() 打印调试

---

2. 使用入口

在 IDEA 2025.1 中，按钮默认不在主调试工具栏，而是被折叠在 调试窗口右上角的 ... 菜单里：

1. 运行程序并进入断点
2. 打开 Debugger 窗口
3. 在 Variables 面板 里选中一个 Stream 变量
4. 点击右上角 ... → 选择 Trace Current Stream Chain

即可看到流的链路和每一步的计算结果。

---

3. 常见问题与限制

• 仅支持源码文件：调试目标必须是你项目中的源码，不适用于 JDK 或三方库里的流。
• 必须有 Stream 变量：只能在调试时、变量存在的上下文里使用。
• 需要断点触发：普通断点要能停住，才能展开调试链。
• 不支持所有操作：部分并行流、特殊自定义 collector 可能无法完全可视化。

---

4. 提高效率的小技巧

4.1 把按钮放到主工具栏

1. 打开调试窗口
2. 右键工具栏 → Customize Toolbar
3. 在 Available Actions 搜索 Trace Current Stream Chain
4. 拖到调试工具栏上
   👉 以后就能一键点击，不用再点 ... 了

---

4.2 设置快捷键

1. 打开 Preferences → Keymap
2. 搜索 Trace Current Stream Chain
3. 给它绑定一个快捷键（比如 Ctrl+Shift+T）
   👉 下次调试直接快捷键触发

---

4.3 配合断点条件使用

你可以在流操作中的某一行加条件断点，例如：

list.stream()
    .map(x -> x * 2)   // 在这里加条件断点：x > 100
    .filter(x -> x % 3 == 0)
    .forEach(System.out::println);

这样进入断点后直接追踪 Stream 链，更快定位问题。

---

✅ 总结

• IDEA 2025.1 的 Stream Debugger 还在，只是藏到了 ... 里。
• 建议把它拖到主工具栏 + 绑定快捷键，一次设置，后续高效调试。