Stream.flatMap处理嵌套目录的核心是将每个目录映射为子路径流再扁平合并，实现一对多到一维流的转换，适用于递归遍历与路径增强。
用 Stream.flatMap 处理嵌套目录结构并获取全路径，核心在于把“目录 → 子目录/文件”的层级关系，通过扁平化转换为一条平铺的路径流。关键不是递归本身，而是让每次展开都返回一个 Stream<path></path>，再由 flatMap 合并所有子流。
理解 flatMap 在路径遍历中的作用
flatMap 接收一个函数，该函数对每个元素返回一个 Stream，然后将所有子流“压平”成单一流。对于目录，每个 Path 可能对应多个子项（子目录 + 文件），所以不能用 map（它只能一对一映射），必须用 flatMap 实现一对多→一维流的转换。
例如：
- 当前路径是 /a，它包含 /a/b（目录）和 /a/c.txt（文件）；
- flatMap 要对 /a 返回 Stream.of(/a/b, /a/c.txt)；
- 若 /a/b 还有子项，下一轮继续展开——这就自然形成深度优先的扁平路径流。
基础实现：单层 flatMap + Files.list
以下代码列出某目录下所有**直接子项**的绝对路径（不含递归）：
Path root = Paths.get("/home/user/project");
try (Stream<Path> stream = Files.list(root)) {
stream.map(Path::toAbsolutePath)
.forEach(System.out::println);
}这只是单层。要递归，需让每个子目录再次触发 Files.list 并合并结果——这正是 flatMap 的用武之地：
public static Stream<Path> walkDirectory(Path dir) {
try {
return Files.list(dir)
.flatMap(child -> {
if (Files.isDirectory(child)) {
return Stream.concat(
Stream.of(child), // 保留当前目录自身（可选）
walkDirectory(child) // 递归获取其下所有路径
);
} else {
return Stream.of(child); // 文件直接发出
}
});
} catch (IOException e) {
return Stream.empty(); // 访问失败则跳过该分支
}
}注意：此写法会引发栈式递归，深层目录可能栈溢出。生产环境建议改用迭代或 Files.walk（见下条）。
推荐方案：结合 Files.walk + flatMap 过滤与转换
JDK 自带的 Files.walk 已完成递归遍历，返回的是完整路径流。此时 flatMap 更适合做“路径增强”或“条件分发”，例如：
- 只保留普通文件，并生成带大小和修改时间的封装对象
- 按扩展名分组，每种类型生成独立路径流
- 将目录路径转为对应资源 URL 流（如 classpath 下的
jar:file:/...!/META-INF/）
实战示例：找出所有 .java 文件，并为每个文件生成其所在包名 + 类名的字符串流：
Path src = Paths.get("src/main/java");
try (Stream<Path> paths = Files.walk(src)
.filter(Files::isRegularFile)
.filter(p -> p.toString().endsWith(".java"))) {
<pre class="brush:php;toolbar:false;">paths.flatMap(p -> {
String rel = src.relativize(p).toString(); // 如 "com/example/App.java"
String pkg = rel.substring(0, rel.length() - 5).replace('/', '.'); // com.example.App
return Stream.of(pkg);
}).forEach(System.out::println);}
这里 flatMap 把每个 Path 映射为一个单元素 Stream<string></string>，最终整个流变成平铺的全限定类名列表。
注意事项与避坑点
不要在 flatMap 中抛出受检异常：Lambda 无法直接 throw IOException。必须包裹在 try-catch 内并返回空流或默认值，否则编译失败。
及时关闭 Stream：Files.list 和 Files.walk 返回的流内部持有资源，务必用 try-with-resources 包裹，否则可能句柄泄漏。
避免重复计算路径：如需同时用到绝对路径、相对路径、文件名、扩展名，建议先用 map 转成自定义对象（如 FileInfo），再用 flatMap 做后续分发，减少重复调用 getFileName()、getParent() 等开销。
慎用 parallelStream：文件 I/O 是阻塞操作，并行流未必提速，还可能因线程竞争导致顺序混乱或资源争用。
