C#如何获取一个文件夹下的所有文件

在C#应用程序开发中，与文件系统交互是不可或缺的基础环节。无论是需要批量处理文档、统计特定目录下的文件数量，还是根据扩展名筛选目标文件，获取指定文件夹下的所有文件列表都是一项极为常见且核心的需求。掌握高效、稳健的文件遍历技术，能够显著提升数据处理程序的执行效率与代码质量。本文将深入探讨在C#中实现这一功能的多种途径，并详细解析不同方案的应用场景与注意事项。

基于Directory类的静态方法实现文件检索

System.IO命名空间下的Directory类提供了一系列用于目录操作的静态方法。其中，GetFiles方法是最直接获取文件列表的工具。该方法的优势在于调用简便，无需实例化对象即可快速返回包含文件完整路径的字符串数组。对于只需要处理单层目录结构的简单场景，这种静态调用方式能够以最低的代码成本完成任务，非常适合快速编写脚本或小型工具。

当业务需求要求深入遍历目标文件夹及其所有嵌套的子文件夹时，我们可以通过向GetFiles方法传递SearchOption枚举值来改变搜索行为。默认情况下，该方法仅搜索当前目录，但通过指定SearchOption.AllDirectories，系统会自动递归扫描所有层级的子目录，从而获取全局的文件路径集合。此外，该方法还支持通配符搜索模式，允许开发者通过类似*.txt的过滤条件，精准定位特定扩展名的文件，极大地简化了文件筛选逻辑。

using System;
using System.IO;

namespace FileRetrieval
{
    class Program
    {
        static void Main()
        {
            string targetPath = @"D:test";
            
            // 仅获取当前目录下的文件
            string[] rootFiles = Directory.GetFiles(targetPath);
            Console.WriteLine("当前目录文件数: " + rootFiles.Length);

            // 获取包含所有子目录的文件
            string[] allFiles = Directory.GetFiles(targetPath, "*", SearchOption.AllDirectories);
            Console.WriteLine("所有文件数: " + allFiles.Length);
        }
    }
}

using System;
using System.IO;

namespace FileRetrieval
{
    class Program
    {
        static void Main()
        {
            string targetPath = @"D:test";
            // 使用通配符筛选txt文件，并递归子目录
            string[] textFiles = Directory.GetFiles(targetPath, "*.txt", SearchOption.AllDirectories);
            
            foreach (string filePath in textFiles)
            {
                Console.WriteLine(filePath);
            }
        }
    }
}

基于DirectoryInfo类的面向对象操作方式

与Directory类的静态方法不同，DirectoryInfo类采用了面向对象的设计模式。在使用前，开发者需要实例化一个DirectoryInfo对象。这种设计的核心优势在于，它的GetFiles方法返回的是FileInfo对象数组，而非简单的字符串路径。FileInfo对象封装了文件的丰富元数据，包括文件大小、创建时间、最后访问时间以及文件属性等。当业务逻辑不仅需要文件路径，还需要对这些属性进行复杂判断或计算时，DirectoryInfo类无疑是更优的选择。

在某些复杂的业务场景中，系统内置的递归遍历可能无法满足所有定制化需求。例如，我们可能需要在遍历过程中跳过某些特定的系统目录或隐藏文件夹，或者在遇到权限受限的目录时进行特殊的降级处理。此时，利用DirectoryInfo获取子目录集合，并通过自定义的递归方法来逐层深入，能够提供最大程度的控制力。这种手动递归的方式虽然代码量稍多，但赋予了开发者在遍历过程中插入自定义逻辑的灵活性。

using System;
using System.IO;
using System.Collections.Generic;

namespace FileRetrieval
{
    class Program
    {
        static void Main()
        {
            string targetPath = @"D:test";
            DirectoryInfo dirInfo = new DirectoryInfo(targetPath);
            
            // 获取FileInfo对象以读取文件属性
            FileInfo[] files = dirInfo.GetFiles();
            foreach (FileInfo file in files)
            {
                Console.WriteLine("文件名: " + file.Name + " 大小: " + file.Length);
            }

            // 自定义递归遍历
            List<FileInfo> customFileList = new List<FileInfo>();
            CollectFilesRecursively(dirInfo, customFileList);
            Console.WriteLine("自定义递归找到文件数: " + customFileList.Count);
        }

        static void CollectFilesRecursively(DirectoryInfo currentDir, List<FileInfo> collection)
        {
            try
            {
                collection.AddRange(currentDir.GetFiles());
                foreach (DirectoryInfo subDir in currentDir.GetDirectories())
                {
                    // 可在此处添加条件判断以跳过特定目录
                    CollectFilesRecursively(subDir, collection);
                }
            }
            catch (UnauthorizedAccessException)
            {
                Console.WriteLine("跳过无权限目录: " + currentDir.FullName);
            }
        }
    }
}

核心差异对比与生产环境最佳实践

在实际的软件工程中，选择Directory还是DirectoryInfo取决于具体的性能需求与功能复杂度。Directory类的静态方法由于无需维护对象状态，在简单的单次查询中内存开销较小，执行速度略快。然而，当需要频繁访问同一目录下的多个文件属性时，DirectoryInfo实例可以缓存部分目录信息，避免重复的底层系统调用。此外，必须高度重视文件系统操作中的异常处理机制。操作系统级别的权限控制、文件被其他进程占用等情况，都可能导致遍历过程意外中断。

为了构建健壮的生产环境代码，开发者应当在执行文件检索前，验证目标路径的有效性。使用Directory.Exists方法可以有效避免因路径不存在而引发的DirectoryNotFoundException异常。同时，对于包含海量文件的深层目录结构，一次性将所有文件路径加载到内存数组中可能会导致内存溢出。在这种情况下，建议采用Directory.EnumerateFiles方法，它返回一个IEnumerable集合，支持延迟执行与流式处理，从而将内存占用控制在极低水平。

using System;
using System.IO;

namespace FileRetrieval
{
    class Program
    {
        static void Main()
        {
            string targetPath = @"D:test";
            
            // 校验路径是否存在
            if (!Directory.Exists(targetPath))
            {
                Console.WriteLine("错误: 指定的文件夹路径不存在");
                return;
            }

            try
            {
                // 使用EnumerateFiles进行流式处理，优化内存
                foreach (string file in Directory.EnumerateFiles(targetPath, "*", SearchOption.AllDirectories))
                {
                    Console.WriteLine(file);
                }
            }
            catch (UnauthorizedAccessException ex)
            {
                Console.WriteLine("权限异常: " + ex.Message);
            }
            catch (PathTooLongException ex)
            {
                Console.WriteLine("路径过长异常: " + ex.Message);
            }
            catch (Exception ex)
            {
                Console.WriteLine("未知异常: " + ex.Message);
            }
        }
    }
}

综上所述，C#提供了丰富且灵活的文件系统操作API，使得获取文件夹下所有文件的需求得以轻松实现。无论是追求简洁高效的Directory静态方法，还是需要深度定制与属性访问的DirectoryInfo面向对象模式，开发者都可以根据实际业务场景做出合理的技术选型。在编写相关代码时，务必将路径校验、异常捕获以及内存优化纳入考量范围，以确保应用程序在面对复杂多变的文件系统环境时，依然能够保持高效与稳定。希望本文的解析与建议，能够为您在未来的C#开发工作中提供有价值的参考与启发。

C#DirectoryInfoGetFilesFileInfo递归遍历修改时间：2026-06-20 21:39:35