Files.walk(Path start, int maxDepth)可限制遍历深度，起始目录为第1层，maxDepth=1仅遍历直接子项，结合filter与findFirst能高效条件搜索，且须用try-with-resources确保流关闭防句柄泄漏。
用 files.walk() 限制目录遍历深度，核心是使用带深度参数的重载方法：files.walk(path start, int maxdepth)。它会在指定层数后自动停止向下递归，避免因嵌套过深导致栈溢出或 i/o 延迟激增。
指定最大遍历深度
直接传入整数 maxDepth（从起始目录算起，起始目录为第 1 层）：
-
Files.walk(path, 1)：只遍历起始目录下的直接子项（不进入子目录） -
Files.walk(path, 2)：进入一级子目录，但不进二级子目录 -
Files.walk(path, Integer.MAX_VALUE)等价于无深度限制的默认行为（慎用）
结合 filter + findFirst 实现条件搜索
在受限深度内高效查找匹配文件，推荐链式调用，避免提前收集全部路径：
Optional<path> result = Files.walk(startDir, 3) // 最多查 3 层
.filter(Files::isRegularFile)
.filter(p -> p.getFileName().toString().endsWith(".log"))
.findFirst();
</path>
这样一旦找到第一个匹配项就立即终止遍历，既控深又省资源。
注意路径层级计算逻辑
maxDepth 是“访问层数”，不是“子目录级数”：
- 起始目录自身算第 1 层（depth = 1）
- 它的直接子目录是第 2 层（depth = 2）
- 子目录的子目录是第 3 层（depth = 3）
- 若设
maxDepth = 2，则不会访问第 3 层及更深路径
异常处理与资源释放
Files.walk() 返回的是 Stream，务必在 try-with-resources 中使用，防止句柄泄漏：
try (Stream<path> stream = Files.walk(startDir, 4)) {
stream.filter(Files::isRegularFile)
.forEach(System.out::println);
} catch (IOException e) {
// 处理权限不足、路径不存在等异常
}
</path>
流未关闭可能导致底层文件系统句柄持续占用，尤其在 Windows 上易触发“Too many open files”错误。
