Files.list()返回Stream，仅列出指定目录直接子项（文件和子目录），不递归、不含"."或".."，需try-with-resources管理资源，遇权限不足等异常可能静默返回空流或抛IOException。
Files.list() 返回的是 Path 流，不是文件内容流
调用 Files.list() 得到的是 Stream<path></path>，每个 Path 对应目录下的一级子项（文件或子目录），不递归、不包含当前目录（.）或父目录（..）。它不会自动过滤隐藏文件或校验可读性，出错时直接抛 IOException —— 所以必须处理异常或用 try-with-resources 包裹。
常见错误是直接遍历却没捕获异常，导致程序崩溃；或者误以为它会跳过不可访问项（比如权限不足的子目录），实际上只要首个不可列项出现，整个流就中断。
- 必须用
try-with-resources保证底层资源释放，否则可能泄漏文件句柄 - 若目录为空，流正常返回但不产生任何元素，不是 null
-
Files.list()不保证顺序，如需按字母排序得显式调用.sorted()
怎么安全获取并遍历一级子文件（排除子目录）
如果只想要普通文件（非目录），不能只靠 Files.list()，得配合 Files.isRegularFile() 过滤。注意：该判断本身也可能抛 IOException（例如符号链接指向不存在路径），所以过滤逻辑要放在 try 块内或使用 peek() + 异常处理策略。
推荐写法是先用 Files.list() 获取流，再用 filter() + Files.isRegularFile()，但要把异常处理前置——更稳妥的方式是用 Files.walk() 配合 maxDepth(1)，它对单个不可访问项会跳过而非中断：
try (Stream<Path> stream = Files.walk(Paths.get("/tmp"), 1)) {
stream
.filter(Files::isRegularFile)
.forEach(System.out::println);
}
不过严格来说，这已不是纯 Files.list() 的用法；若坚持用 list()，就得自己包裹异常：
try (Stream<Path> stream = Files.list(dirPath)) {
stream.filter(path -> {
try {
return Files.isRegularFile(path);
} catch (IOException e) {
return false;
}
}).forEach(...);
}
Files.list() 和 Files.walk(1) 的关键区别在哪
核心差异在容错能力和语义明确性：Files.list() 是“尽力列出，失败即停”；Files.walk(dir, 1) 是“尽力遍历一层，单个失败跳过，继续”。后者底层用了类似迭代器的容错机制，适合生产环境。
-
Files.list()更轻量，无递归开销，但脆弱 -
Files.walk(dir, 1)多一次深度控制，内部做了异常抑制，但创建了额外的DirectoryStream封装 - 两者都不解析符号链接目标，默认按路径原样返回（即链接本身算一个“文件”）
- Windows 下若目录含长路径或特殊字符，
list()更容易因InvalidPathException中断
为什么 Files.list() 有时返回空流却没报错
最常见原因是目录路径存在但**没有读取权限**，此时 JDK 的行为是静默返回空流（而非抛异常），尤其在 Linux/Unix 系统上。这不是 bug，是 POSIX 层面的限制：进程能进入目录（执行位 x），但无读权限（r）时，getdents() 系统调用返回成功但条目数为 0。
验证方式很简单：
System.out.println(Files.isReadable(dirPath)); // false System.out.println(Files.isDirectory(dirPath)); // true
这时候即使 dirPath 真实存在且是目录，Files.list() 也只会给你一个空流。别猜，先查权限。
另一个隐蔽原因是路径末尾有斜杠但实际是文件（比如 /path/to/file/），此时 Files.isDirectory() 返回 false，Files.list() 直接抛 NotDirectoryException —— 但很多人没 catch 它，导致空流错觉。
