Java实现文件夹顶层文件计数：忽略隐藏文件与嵌套文件夹

需求说明 #

需要统计指定文件夹顶层的文件数量，满足：

• 忽略以.开头的类Unix隐藏文件
• 忽略嵌套文件夹，不递归统计子文件夹内的文件

示例目录结构：

📂 Sales 
    📂 Wine Sales 2024 
        📄 .DS_Store
        📄 Interim report.text
        📂 Q1
            📄 West region.text
            📄 East region.text
        📂 Q2
        📂 Q3
        📂 Q4

指定Wine Sales 2024文件夹时，期望计数为1（仅统计Interim report.text）。

已尝试的方法及问题 #

1. File#listFiles #

尝试代码：

final int countFilesFound = Objects.requireNonNull( path.toFile( ).listFiles( ( folder , name ) -> !name.startsWith( "." ) ) ).length;

存在的问题：

• ❌ 会将嵌套文件夹计入数量，不符合忽略文件夹的要求
• ✅ 可正确忽略以.开头的隐藏文件
• ❌ 需要将Path转换为File，略显冗余
• ❌ 实现间接，需先创建数组再获取长度

2. Files.list（Java 8+ NIO） #

改编后的部分解决方案：

final long count;
try
{
    count = Files.list( path ).filter( Files :: isRegularFile ).count( );
}
catch ( IOException e )
{
    throw new RuntimeException( e );
}

存在的问题：

• ❌ 必须包裹在try-catch中，代码冗余
• ❌ IDE要求使用try-with-resources，不理解为何带终端操作（如count()）的流需要手动关闭
• ✅ 可正确忽略嵌套文件夹

最终简便解决方案 #

优化后的代码 #

结合Files.list的优势，同时满足所有需求的简洁实现：

try (Stream<Path> stream = Files.list(path)) {
    long count = stream
            .filter(Files::isRegularFile) // 过滤普通文件，排除文件夹
            .filter(p -> !p.getFileName().toString().startsWith(".")) // 忽略隐藏文件
            .count();
} catch (IOException e) {
    throw new UncheckedIOException(e); // 转为非受检异常，简化调用
}

封装为工具方法 #

如果需要多次调用，可封装成工具方法，进一步简化：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.stream.Stream;

public class FileCountUtils {
    public static long countTopLevelNonHiddenFiles(Path dir) {
        try (Stream<Path> stream = Files.list(dir)) {
            return stream
                    .filter(Files::isRegularFile)
                    .filter(p -> !p.getFileName().toString().startsWith("."))
                    .count();
        } catch (IOException e) {
            throw new UncheckedIOException("Failed to count files in directory: " + dir, e);
        }
    }
}

关于try-with-resources的说明 #

Files.list()返回的流属于资源绑定流，背后关联着文件系统的底层资源（如目录句柄）。即使调用了count()这类终端操作，JVM也无法保证资源被自动释放，因此必须通过try-with-resources确保资源被正确关闭，避免潜在的资源泄漏。

内容的提问来源于stack exchange，提问作者Basil Bourque