files.newdirectorystream 是 java 7 提供的高效目录遍历工具，支持延迟加载、过滤和资源可控，需用 try-with-resources 确保关闭，配合 glob 或 filter 减少无效 i/o，优先调用 readattributes 批量获取文件属性，遍历后按需并发处理。
files.newdirectorystream 是 java 7 引入的高效目录遍历工具，相比 file.listfiles() 或 files.list()，它支持延迟加载、过滤和资源可控，特别适合处理数万文件的大目录——关键在于避免一次性加载全部路径、减少内存占用并支持按需处理。
用 try-with-resources 确保流及时关闭
newDirectoryStream 返回的是 DirectoryStream<path></path>，它实现了 AutoCloseable。不显式关闭会导致底层文件系统句柄泄漏，尤其在循环处理大量目录时容易触发“Too many open files”错误。
- 务必用 try-with-resources 包裹，哪怕只遍历一次
- 不要把它赋值给类成员变量或长期持有
- 示例写法：
for (Path entry : stream) {
// 处理单个文件，如检查是否为 .log
}
}
配合 Glob 或自定义过滤器跳过无关项
默认遍历所有条目（包括子目录、隐藏文件、临时文件），对数万文件来说，无效条目会白白消耗 I/O 和 CPU。利用第二个参数指定过滤条件，让操作系统层（或 JVM）提前筛掉。
- 用 Glob 模式最简洁，如
"*.txt"、"data-202[4-9]-*.json" - 需要复杂逻辑（如按修改时间、文件大小、正则匹配）时，传入
DirectoryStream.Filter<path></path>实现 - 注意：Glob 在不同平台行为一致，但通配符不支持全正则；Filter 中抛出异常会被静默吞掉，建议只做轻量判断
避免在循环体内反复调用 Files.isXxx()
如果需要同时判断类型（是文件还是目录）、可读性、存在性等，不要对每个 Path 都单独调用 Files.isRegularFile(p) 或 Files.size(p) —— 这会引发多次系统调用，显著拖慢速度。
- 改用
Files.readAttributes(p, BasicFileAttributes.class)一次性获取创建/修改时间、大小、类型、权限等 - 对确定要处理的文件，再按需调用
Files.size()或Files.getLastModifiedTime() - 若只需区分文件/目录，且已用 Glob 过滤（如
"*"），可结合Files.isDirectory(p)快速分支
批量处理 + 适度并发提升吞吐（谨慎使用）
纯遍历本身是 I/O 密集型，CPU 占用不高；但如果后续要解析内容、计算哈希、入库等，则可考虑将路径收集后分批提交到线程池。但注意：DirectoryStream 本身不保证线程安全，不可多线程同时迭代同一 stream。
- 推荐模式：单线程遍历 → 收集 Path 到阻塞队列 → 多个工作线程消费
- 每批 100–500 个路径为宜，避免队列过大占内存
- 慎用并行流（
stream.parallel()），因底层仍是单次系统调用，收益小、调试难、易出错
