Files.walk() 提供安全简洁的全路径遍历，但需 try-catch 处理 IOException；应避免纯递归防 StackOverflowError，改用显式栈；Files.find() 可深度优先早终止，walk() 需后过滤；Windows 中文/长路径需启用系统长路径支持并妥善处理异常。
用 Files.walk() 快速实现全路径文件搜索
Java 8+ 提供了 Files.walk()，它比手写递归更安全、简洁，且自动处理符号链接和权限异常。直接遍历整个目录树时，它返回一个 Stream<path></path>，可链式过滤。
常见错误是忽略 IOException 导致程序中断——walk() 默认抛出 unchecked 异常，但实际 I/O 失败（如拒绝访问某子目录）会终止流。必须用 Files.walk(path, Integer.MAX_VALUE).onClose(() -> {})... 并配合 try-catch 包裹终端操作（如 collect()）。
使用场景：查找项目中所有 .java 文件、扫描配置目录下的 application-*.yml。
Path start = Paths.get("/home/user/project");
try (Stream<Path> stream = Files.walk(start)) {
stream.filter(Files::isRegularFile)
.filter(p -> p.toString().endsWith(".log"))
.forEach(System.out::println);
} catch (IOException e) {
// 注意：e 来自 walk() 内部首次 I/O 失败，不是每个文件都抛
}
手动递归遍历时如何避免 StackOverflowError
深度过大的目录（如 /usr/include）用纯递归容易爆栈。JVM 默认栈大小约 1MB，每层调用占几百字节，几千层就挂。
立即学习“Java免费学习笔记（深入）”；
解决方案不是加大 -Xss，而是改用显式栈（stack-based traversal）模拟递归：
- 用
Deque<path></path>存待处理目录，而非方法调用栈 - 每次
pop()一个路径，list()其子项，把子目录push()回去 - 跳过
Files.isSymbolicLink()和!Files.isDirectory()的路径，防止循环或中断
这样内存占用可控，且能精细控制访问顺序（比如先文件后目录，或按名称排序再遍历）。
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
Files.find() 和 Files.walk() 的关键区别在哪
二者都用于搜索，但语义和行为不同：find() 是“带深度限制的条件搜索”，walk() 是“无条件遍历后过滤”。
Files.find(start, maxDepth, biPredicate) 在遍历过程中逐个判断，一旦某目录超过 maxDepth 就跳过其全部子树；而 walk(start, maxDepth) 仅控制层数，之后仍需用 filter() 筛文件——这意味着即使你只想要根目录下 .txt，walk 仍会打开所有子目录句柄再丢弃。
性能差异明显：对大目录且搜索条件早匹配的场景（如找第一个 README.md），find() 可提前终止子树遍历；walk() 则必须走完指定深度。
参数注意：maxDepth=1 表示只查起始目录本身及其直接子项（不递归），0 表示只查起始路径（即单个文件或空目录）。
Windows 下中文路径或长路径报 InvalidPathException 怎么办
这不是 Java 问题，是 Windows API 限制：传统 Win32 路径长度上限 260 字符，且某些字符（如 ?、）在未转义时触发解析失败。
解决方式分两步：
- 确保 JVM 启动时加参数
-Djava.io.tmpdir=C: emp（避免临时路径含中文） - 对用户输入的路径，用
Paths.get(URI.create("file:///" + path.replace("\", "/")))绕过 UNC 路径解析缺陷 - 更稳妥的是启用 Windows 长路径支持（组策略 → “启用 Win32 长路径”，或修改注册表
HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlFileSystemLongPathsEnabled = 1）
注意：Files.walk() 在遇到非法路径时抛 InvalidPathException，但该异常不会被流自动吞掉——必须在外层 try-catch，否则静默失败。
