Files.list 是 Java 8+ 中遍历目录下一级文件最轻量高效的方式，返回延迟加载 Stream，不递归、不包含 . 或 ..，需用 try-with-resources 处理 IOException。
使用 Files.list 是 Java 8+ 中遍历目录**下一级**文件（不递归）最轻量、高效的方式之一，它返回一个延迟加载的 Stream<path></path>，避免一次性加载全部路径，内存友好且支持函数式操作。
基本用法：只获取当前目录下的直接子项
Files.list 不会递归子目录，也不会包含当前目录（.）或父目录（..），天然安全。需注意它只列出“可访问”的条目，遇到权限不足或 I/O 异常会抛出 IOException，所以必须处理异常或用 try-with-resources 包裹流：
- 直接遍历打印文件名：
stream.forEach(path -> System.out.println(path.getFileName()));
}
- 过滤出普通文件（排除目录）：
stream.filter(Files::isRegularFile)
.forEach(System.out::println);
}
与 Files.walk 的关键区别：别用错场景
Files.list 是单层、非递归；Files.walk 才是递归遍历整棵树。如果误用 walk(1) 模拟单层，反而多一层封装、性能略低，且默认包含起始路径（需跳过）。所以明确只要一级子项时，坚持用 list 更直接、更高效。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
常见增强技巧：排序、限制、异常防护
实际使用中常需进一步控制结果，推荐组合 Stream 操作：
立即学习“Java免费学习笔记（深入）”；
- 按文件名升序排列：
.sorted(Comparator.comparing(p -> p.getFileName().toString())) - 只取前 10 个：
.limit(10)（配合sorted可实现“取最新 10 个文件”逻辑） - 安全跳过不可读项（不中断整个流）：
用Files.list+filter+Files.isReadable，但注意isReadable对符号链接等可能返回 false；更稳妥做法是用Files.find或捕获AccessDeniedException后继续 —— 但list本身不提供跳过异常的内置机制，因此建议确保调用方有足够权限，或改用Files.newDirectoryStream配合手动 try-catch。
替代方案对比：什么时候该选 Files.newDirectoryStream？
若需更高控制力（如自定义过滤器、避免 IOException 中断流、或兼容老版本 Java），Files.newDirectoryStream(Path, String glob) 是更底层的选择。它返回 DirectoryStream（Iterable），支持 glob 模式（如 "*.log"），且异常由调用方自行处理。但它不返回 Stream，函数式链式操作不如 list 方便。日常开发中，优先用 list；有特殊过滤或异常容忍需求时，再考虑 newDirectoryStream。
