Files.walkFileTree() 的核心控制逻辑在于 SimpleFileVisitor 子类重写的回调方法：preVisitDirectory、visitFile、visitFileFailed 和 postVisitDirectory，其返回值决定遍历行为；需在 preVisitDirectory 中用 Objects.equals 判断并返回 SKIP_SUBTREE 跳过特定目录，在 visitFile 中过滤文件但不可对文件返回 SKIP_SUBTREE；visitFileFailed 必须重写以捕获 AccessDeniedException 等异常并返回 CONTINUE，避免遍历中断；visitFile 中的 Path 是相对路径，应通过构造器传入 basePath 并用 basePath.resolve(file) 获取正确绝对路径。
Files.walkFileTree() 的核心控制逻辑在哪
关键不在走树本身，而在于 SimpleFileVisitor 子类里重写的那几个回调方法——preVisitDirectory、visitFile、visitFileFailed 和 postVisitDirectory。它们按实际访问顺序被调用，每个方法返回值决定是否继续遍历：FileVisitResult.CONTINUE 继续，TERMINATE 立即中断，SKIP_SUBTREE 跳过当前目录下所有子项。
怎么跳过特定目录或文件（比如 .git 或 class 文件）
不能靠路径字符串匹配后 return，必须在对应回调里返回 SKIP_SUBTREE 或 CONTINUE。常见错误是只过滤文件名却没处理目录，结果 .git 目录仍被递归进入。
-
preVisitDirectory：检查dir的getFileName()，如果是".git"或"target"，直接 returnFileVisitResult.SKIP_SUBTREE -
visitFile：用file.getFileName().toString().endsWith(".class")判断，匹配则跳过处理，但别 returnSKIP_SUBTREE（它对文件无效） - 注意：路径比较要用
Objects.equals(dir.getFileName(), Path.of(".git"))，避免因大小写或符号链接导致漏判
如何安全捕获并处理权限不足或 I/O 错误
visitFileFailed 是唯一能拿到异常对象的地方，不重写它，AccessDeniedException 或 IOException 会直接中断整个遍历。它默认返回 CONTINUE，但你得显式处理。
- 如果只是想跳过无法读取的文件，return
FileVisitResult.CONTINUE即可 - 如果要记录错误，把
IOException传入日志，再 returnCONTINUE；不要 throw 新异常，否则遍历终止 - 特别注意 Windows 下的
java.nio.file.AccessDeniedException常出现在System Volume Information目录，必须在这里吞掉
为什么 visitFile() 拿到的 Path 不是绝对路径，且可能和 walk 开始时的 base 不一致
因为 Files.walkFileTree() 默认以相对路径方式传递给 visitor 方法。如果你需要完整路径做后续操作（比如复制、删除），必须在构造 visitor 时把起始 Path 传进去，然后在 visitFile 里用 basePath.resolve(file) 拼接。
- 错误做法：
file.toAbsolutePath()—— 它返回的是基于当前工作目录的绝对路径，不是原树根下的绝对路径 - 正确做法：在自定义
SimpleFileVisitor构造器中接收Path root，在visitFile中用root.resolve(file) - 性能提示：
resolve()是轻量操作，但频繁调用仍建议缓存root字段，而非每次重新Paths.get(...)
实际最易忽略的是 visitFileFailed 的沉默失败行为——不重写它，某些系统目录报错就停了，你以为遍历完了，其实差了一半。
