如何使用 File.listFiles 配合文件名过滤器筛选指定后缀文件

在Java的IO操作中，File类的listFiles方法可以获取指定目录下的所有文件或目录对象，结合文件名过滤器能够实现按指定规则筛选文件的需求，其中筛选指定后缀文件是最典型的应用场景之一。

File.listFiles 方法基础说明

File类的listFiles方法有多个重载形式，其中支持传入过滤器参数的重载方法可以返回符合过滤规则的文件和目录数组。如果不传入任何参数，listFiles会返回目录下所有的文件和目录对象；如果传入过滤器，只会返回满足过滤器条件的对象。

方法的定义如下：

public File[] listFiles(FilenameFilter filter)

其中FilenameFilter是一个函数式接口，内部只有一个accept方法，用来定义过滤规则。

文件名过滤器 FilenameFilter 介绍

FilenameFilter接口位于java.io包下，其定义非常简单，只有一个抽象方法：

@FunctionalInterface
public interface FilenameFilter {
    boolean accept(File dir, String name);
}

方法参数说明：

• dir：当前遍历到的文件所在的目录对象
• name：当前遍历到的文件或目录的名称

返回值说明：如果返回true，说明当前文件或目录符合过滤规则，会被加入到listFiles返回的结果数组中；如果返回false，则会被过滤掉。

实现指定后缀文件筛选的两种方式

方式一：匿名内部类实现过滤器

这是Java 8之前常用的实现方式，直接创建FilenameFilter的匿名内部类，在accept方法中编写后缀判断逻辑。

以下示例实现筛选指定目录下所有.txt后缀的文件：

import java.io.File;
import java.io.FilenameFilter;

public class FileFilterDemo {
    public static void main(String[] args) {
        // 指定要筛选的目录，这里使用当前项目根目录，也可以替换为实际目录路径
        File dir = new File("./");
        // 定义要筛选的后缀
        String targetSuffix = ".txt";
        
        // 使用匿名内部类实现文件名过滤器
        FilenameFilter filter = new FilenameFilter() {
            @Override
            public boolean accept(File dir, String name) {
                // 判断文件名是否以目标后缀结尾
                return name.endsWith(targetSuffix);
            }
        };
        
        // 获取符合过滤条件的文件数组
        File[] filteredFiles = dir.listFiles(filter);
        
        // 遍历输出结果
        if (filteredFiles != null) {
            System.out.println("筛选到的" + targetSuffix + "文件如下：");
            for (File file : filteredFiles) {
                System.out.println(file.getName());
            }
        } else {
            System.out.println("指定目录不存在或者不是一个目录");
        }
    }
}

方式二：Lambda表达式实现过滤器

由于FilenameFilter是函数式接口，Java 8及以上版本可以使用Lambda表达式简化实现，代码更加简洁。

import java.io.File;
import java.io.FilenameFilter;

public class FileFilterLambdaDemo {
    public static void main(String[] args) {
        File dir = new File("./");
        String targetSuffix = ".txt";
        
        // 使用Lambda表达式实现过滤器
        FilenameFilter filter = (dirPath, name) -> name.endsWith(targetSuffix);
        
        File[] filteredFiles = dir.listFiles(filter);
        
        if (filteredFiles != null) {
            System.out.println("筛选到的" + targetSuffix + "文件如下：");
            for (File file : filteredFiles) {
                System.out.println(file.getName());
            }
        } else {
            System.out.println("指定目录不存在或者不是一个目录");
        }
    }
}

注意事项

• listFiles方法返回的结果可能为null，当传入的File对象不是目录，或者目录无法访问时，会返回null，使用前需要做非空判断，避免空指针异常。
• endsWith方法判断后缀时是严格区分大小写的，如果需要忽略大小写筛选，比如同时匹配.txt和.TXT，可以将文件名和后缀都转为小写后再判断：name.toLowerCase().endsWith(targetSuffix.toLowerCase())。
• 过滤器只会过滤当前目录下的直接子文件，不会递归筛选子目录中的文件，如果需要递归筛选所有子目录中的指定后缀文件，需要额外编写递归遍历逻辑。
• 如果目录中包含隐藏文件，只要符合后缀规则，也会被筛选出来，如果不需要隐藏文件，可以在accept方法中增加判断：!new File(dir, name).isHidden()。

扩展：递归筛选所有子目录的指定后缀文件

如果需要筛选指定目录及其所有子目录中的指定后缀文件，可以结合listFiles和递归实现，示例代码如下：

import java.io.File;
import java.util.ArrayList;
import java.util.List;

public class RecursiveFileFilterDemo {
    public static void main(String[] args) {
        File rootDir = new File("./");
        String targetSuffix = ".txt";
        List<File> result = new ArrayList<>();
        
        // 调用递归方法筛选文件
        filterFilesRecursive(rootDir, targetSuffix, result);
        
        System.out.println("所有" + targetSuffix + "文件如下：");
        for (File file : result) {
            System.out.println(file.getAbsolutePath());
        }
    }
    
    private static void filterFilesRecursive(File dir, String suffix, List<File> result) {
        if (dir == null || !dir.isDirectory()) {
            return;
        }
        // 获取当前目录下的所有文件和目录
        File[] files = dir.listFiles();
        if (files == null) {
            return;
        }
        for (File file : files) {
            if (file.isDirectory()) {
                // 如果是目录，递归遍历
                filterFilesRecursive(file, suffix, result);
            } else if (file.isFile() && file.getName().endsWith(suffix)) {
                // 如果是文件且符合后缀要求，加入结果集
                result.add(file);
            }
        }
    }
}

File.listFiles文件名过滤器文件后缀筛选Java_IO修改时间：2026-07-05 17:18:26