如何在Java中创建接收操作系统文件夹名、返回其及子文件夹文件总数的函数

以下提供两种常用实现方式，均包含入参合法性校验。

实现1：Java 8+ NIO 实现（推荐，无栈溢出风险） #

该方案基于Files.walk迭代遍历所有路径，性能更稳定，适合层级深的目录场景：

import java.nio.file.Files;
import java.nio.file.Paths;

public long countTotalFiles(String folderPath) throws IllegalArgumentException {
    // 校验入参是否为有效目录
    var targetPath = Paths.get(folderPath);
    if (!Files.exists(targetPath) || !Files.isDirectory(targetPath)) {
        throw new IllegalArgumentException("传入路径不是合法操作系统目录");
    }
    // try-with-resources自动关闭流避免资源泄漏
    try (var pathStream = Files.walk(targetPath)) {
        // 仅统计普通文件，排除目录、软链接等特殊节点
        return pathStream.filter(Files::isRegularFile).count();
    } catch (Exception e) {
        throw new RuntimeException("文件统计失败：" + e.getMessage(), e);
    }
}

实现2：传统递归实现（兼容Java 8以前版本） #

适合低版本Java环境，注意层级极深的目录可能触发栈溢出：

import java.io.File;

public long countTotalFiles(String folderPath) throws IllegalArgumentException {
    File folder = new File(folderPath);
    if (!folder.exists() || !folder.isDirectory()) {
        throw new IllegalArgumentException("传入路径不是合法操作系统目录");
    }
    long fileCount = 0;
    File[] childNodes = folder.listFiles();
    // 无权限读取目录时listFiles返回null
    if (childNodes == null) {
        return fileCount;
    }
    for (File node : childNodes) {
        if (node.isFile()) {
            fileCount++;
        } else if (node.isDirectory()) {
            fileCount += countTotalFiles(node.getAbsolutePath());
        }
    }
    return fileCount;
}

注意事项 #

• 两种实现的计数范围均为普通文件，不会将目录本身计入总数
• 遇到无权限访问的目录时，可根据业务需求调整异常处理逻辑，比如跳过无权限目录继续统计
• 大目录统计建议加超时逻辑，避免IO阻塞影响业务流程

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