Files.walk()的depth参数控制目录树遍历深度，起始目录为第0层，每进入一级子目录depth+1；例如depth=2时遍历起始目录、其子目录及子目录的子目录，但不进入第3级。
Files.walk() 的 depth 参数到底控制什么
它控制的是目录树的遍历深度，不是文件路径的层级数。从起始目录算作第 0 层，每进入下一级子目录 depth +1。比如 Files.walk(path, 2) 会访问：起始目录（0）、其直接子目录（1）、子目录的子目录（2），但不会进入第 3 级。
常见误解是以为 depth=2 就只查两层深的文件，结果漏掉同级但路径更长的符号链接目标——Files.walk() 默认不跟随符号链接，这点和 shell 的 find -maxdepth 行为不同。
如何安全地限制深度并过滤出普通文件
直接用 Files.walk() 配合 filter() 最简洁，但要注意两点：一是必须先调用 forEach() 或 collect() 触发遍历，二是避免在流关闭后继续操作。
- 用
Files.walk(start, maxDepth)获取流，再链式调用.filter(Files::isRegularFile) - 不要在
filter()里做耗时 I/O（如Files.size()），否则性能骤降 - 如果需排除特定目录（如
.git），得在filter()前加.filter(p -> !p.toString().contains("/.git/"))，不能依赖 depth 控制
try (Stream<path> stream = Files.walk(start, 3)) {
stream.filter(Files::isRegularFile)
.filter(p -> p.toString().endsWith(".log"))
.forEach(System.out::println);
}</path>
遇到 AccessDeniedException 怎么办
Files.walk() 在权限不足时默认抛异常并中断整个流，无法跳过。必须用重载版本 Files.walk(start, maxDepth, FileVisitOption...) 并传入 FileVisitOption.FOLLOW_LINKS ——但这不解决权限问题；真正解法是改用 Files.walkFileTree() 手动处理。
如果坚持用 walk()，唯一办法是提前过滤掉已知受限路径（如 /proc、/sys），或捕获异常并转为 warning 日志，但流会终止。
- 推荐替代方案：
Files.walkFileTree()配合自定义SimpleFileVisitor，在visitFileFailed()中返回FileVisitResult.CONTINUE - Java 17+ 可用
Files.find()，它内部已处理权限异常，行为更接近预期
Windows 路径分隔符与大小写敏感性陷阱
在 Windows 上，Files.walk() 返回的 Path 对象使用反斜杠 ，但 toString() 结果可能混用正斜杠。用 Path.getFileName() 或 Path.getParent() 比字符串匹配更可靠。
另外，Windows 文件系统默认不区分大小写，但 Files.walk() 不做任何转换。如果你写 p.toString().endsWith(".LOG")，在 Windows 上会漏掉小写的 .log 文件。
- 统一用
String.equalsIgnoreCase()或正则Pattern.compile("\.log$", Pattern.CASE_INSENSITIVE) - 避免硬编码路径拼接，用
Paths.get("a", "b", "c")代替"a/b/c" - 测试时务必在目标操作系统上验证，跨平台代码不能只看 Linux 行为
实际用的时候，depth 控制的是目录结构深度，不是文件数量或路径长度；权限异常无法靠参数绕过；Windows 下的字符串匹配比你想象中更容易出错。
