Files.walk() 遍历目录需用 try-with-resources 捕获 IOException，过滤时统一转小写；Files.find() 支持深度限制与属性谓词，注意 maxDepth=1 表示仅直接子项；中文路径须设 -Dfile.encoding=UTF-8 并用 Paths.get(URI) 构造。
用 Files.walk() 遍历目录并过滤文件名
Java 8+ 推荐用 Files.walk() 替代递归 File.listFiles()，它天然支持深度优先遍历、自动处理符号链接（可选），且返回 Stream 方便链式过滤。
常见错误是忽略异常处理——Files.walk() 在遇到权限不足或路径不存在时会抛 IOException，直接调用不捕获会导致流中断。正确做法是用 try-with-resources 包裹，或提前用 Files.isReadable() 做守卫：
try (Streampaths = Files.walk(startDir)) { paths.filter(p -> p.getFileName().toString().toLowerCase().contains(keyword)) .forEach(System.out::println); }
注意：keyword 大小写敏感，建议统一转小写比对；若需通配符（如 *.log），别硬匹配，改用 Files.isRegularFile() + String.endsWith() 或 FilenameFilter。
用 Files.find() 实现带条件的快速搜索
Files.find() 是 walk() 的增强版，支持指定最大深度和自定义 BiPredicate，适合“只查当前目录下所有 .txt 文件”这类明确范围的场景。
立即学习“Java免费学习笔记（深入）”；
容易踩的坑：误把 maxDepth 设为 0（只查起点本身，不是子项）；或在谓词中调用 Files.isSymbolicLink() 等 I/O 方法却不处理异常——这些方法可能抛 IOException，而谓词接口不声明抛出，必须内部 try-catch 吞掉或转为 false：
-
maxDepth = 1表示只遍历起始目录下的直接子项 - 谓词里避免重复调用
Files.size()或Files.getLastModifiedTime()，它们触发系统调用，影响性能 - 若需按内容搜索，
find()仅负责定位文件，内容读取必须另起线程或分批处理，否则阻塞整个流
处理中文路径和特殊字符时的编码陷阱
Java 运行时默认使用平台编码解析路径字符串，Windows 中文系统常为 GBK，但 Paths.get("C:\用户\test.txt") 在 UTF-8 环境下可能报 InvalidPathException 或静默错位。根本原因不是 Java 不支持中文路径，而是 IDE/终端/启动脚本的编码与 JVM 参数不一致。
实操建议：
- 强制 JVM 使用 UTF-8：启动时加
-Dfile.encoding=UTF-8 - 路径字符串一律用
Paths.get(URI)构造，例如Paths.get(new URI("file:///C:/用户/test.txt"))，URI 自动做百分号编码转换 - 避免拼接路径：用
Path.resolve()代替+，防止正斜杠/反斜杠混用或开头多出/
如果搜索结果为空但路径肉眼可见，优先检查 startDir.toAbsolutePath().toString() 输出，确认路径字符串是否已乱码。
避免阻塞主线程：小文件内容搜索的轻量异步方案
单纯查文件名用 walk() 足够快，但若要 grep 内容（比如找包含 "ERROR" 的日志行），同步读每个文件极易卡 UI 或拖慢响应。不用引入完整线程池，可用 CompletableFuture.supplyAsync() 包一层：
var future = CompletableFuture.supplyAsync(() -> {
try (var lines = Files.lines(path, StandardCharsets.UTF_8)) {
return lines.anyMatch(line -> line.contains("ERROR"));
} catch (IOException e) {
return false;
}
});
关键点：
- 必须指定
StandardCharsets.UTF_8，否则依赖平台默认编码，中文内容大概率乱码 -
lines()返回的流需显式关闭（try-with-resources），否则文件句柄泄漏 - 不要在 lambda 里直接
System.out.println()—— 异步执行顺序不可控，应返回布尔值再由主线程聚合结果
真正复杂的地方不在语法，而在路径有效性校验、编码一致性、I/O 异常的静默吞并边界——这些地方不写测试，上线后只会收到“搜不到文件”的模糊反馈。
