Files.walk() 遍历更安全，因内置深度限制、循环检测与异常恢复；返回Stream支持链式过滤和并行；需用try-with-resources关闭；匹配文件名依需求选contains()或matches()；务必先filter(Files::isRegularFile)；Windows中文路径须用Paths.get()和UTF-8编码。
用 Files.walk() 遍历目录比手写递归更安全
手动写递归遍历文件容易触发栈溢出或忽略符号链接导致死循环，Files.walk() 内部已处理路径深度限制、循环引用检测和 I/O 异常中断恢复。它返回 Stream，天然支持链式过滤与并行处理。
- 默认深度无限制，但可传入
maxDepth参数控制（如Files.walk(path, 3)） - 遇到权限不足的子目录时不会抛异常，而是跳过 —— 若需捕获这类情况，得配合
SimpleFileVisitor - 注意：Java 8+ 才有，且流未关闭前底层资源可能未释放；务必用 try-with-resources 或显式调用
stream.close()
匹配文件名用 String.contains() 还是 Path.getFileName().toString().matches()？
取决于搜索意图。模糊关键词搜（如“log”匹配 error.log、mylog.txt）用 contains() 更快；精确模式匹配（如“*.tmp”或“config-\\d{4}.json”）必须用正则 + matches()。
-
Path.getFileName()返回的是不含路径的文件名，避免误匹配父目录名 - 正则中注意转义：
"config-\\\\d{4}\\.json"（Java 字符串里反斜杠要双写，点号需转义） - 不区分大小写搜索：用
toLowerCase().contains(keyword.toLowerCase())，比正则(?i)更轻量
搜索大目录时卡顿？加 Files.isRegularFile() 提前过滤
Files.walk() 默认遍历所有条目（包括目录、符号链接、设备文件），但多数搜索只关心普通文件。漏掉这个判断会导致大量无效路径参与后续字符串匹配，CPU 和 I/O 负载陡增。
- 必须在
f链中尽早调用：
ilter()
Files.walk(path).filter(Files::isRegularFile) - 不要写成
filter(p -> Files.isRegularFile(p))—— 方法引用更简洁且避免隐式异常包装 - 若还需排除某些后缀（如
.class），把isRegularFile()放在最前面，利用短路逻辑减少后续判断
Windows 下中文路径乱码？别碰 new File(...).listFiles()
旧 API File.listFiles() 在 Windows 控制台默认编码为 GBK，而 JDK 通常按 UTF-8 解析路径字符串，导致 Path 对象内部字节错乱，后续 toString() 显示为问号或方块。全程使用 NIO.2 接口可规避。
- 路径输入统一用
Paths.get("C:\\用户\\文档")，而非new File("C:\\用户\\文档") - 终端运行时确保 JVM 启动参数含
-Dfile.encoding=UTF-8 - 如果必须兼容老旧环境，用
StandardCharsets.UTF_8显式解码原始字节数组（极少见）
Path root = Paths.get("C:/search");
String keyword = "report";
try (Stream stream = Files.walk(root)
.filter(Files::isRegularFile)
.filter(p -> p.getFileName().toString().toLowerCase().contains(keyword.toLowerCase()))) {
stream.forEach(System.out::println);
}
递归深度、符号链接、编码、文件类型判断 —— 这四个点没对齐，搜索结果就不可靠。尤其在跨平台部署时，Files.walk() 的行为一致性远高于 File.list()。
