C#获取目录下文件列表：全面解析与实战指南在C#编程中，获取指定目录下的文件列表是一项常见且重要的文件系统操作。我们这篇文章将详细介绍7种常用方法及其适用场景，帮助开发者根据需求选择最优解决方案。主要内容包括：Directory.GetF

C#获取目录下文件列表：全面解析与实战指南

在C#编程中，获取指定目录下的文件列表是一项常见且重要的文件系统操作。我们这篇文章将详细介绍7种常用方法及其适用场景，帮助开发者根据需求选择最优解决方案。主要内容包括：Directory.GetFiles方法；DirectoryInfo类实现；LINQ扩展方法；异步获取方式；递归获取子目录文件；过滤特定类型文件；异常处理与权限管理。通过代码示例和性能对比，让您全面掌握C#文件列表获取技术。

一、Directory.GetFiles基础用法

这是System.IO命名空间提供的最直接方法：

// 获取目录下所有文件
string[] allFiles = Directory.GetFiles(@"C:\MyFolder");

// 按扩展名过滤（获取所有txt文件）
string[] textFiles = Directory.GetFiles(@"C:\MyFolder", "*.txt");

// 综合搜索选项（包含子目录）
var allFilesRecursive = Directory.GetFiles(@"C:\MyFolder", "*.*", 
    SearchOption.AllDirectories);

特点分析：同步执行、支持通配符过滤、可设置搜索范围。需要注意的是，当目录不存在时会抛出DirectoryNotFoundException。

二、DirectoryInfo面向对象实现

通过文件系统对象模型获取更丰富的文件信息：

DirectoryInfo dirInfo = new DirectoryInfo(@"C:\MyFolder");

// 获取文件集合
FileInfo[] files = dirInfo.GetFiles();

// 获取特定类型文件（不区分大小写）
var jpgFiles = dirInfo.GetFiles("*.jpg", SearchOption.TopDirectoryOnly);

// 访问文件属性示例
foreach (var file in files)
{
    Console.WriteLine($"{file.Name} - {file.Length / 1024}KB");
}

优势：返回FileInfo对象包含完整文件属性（创建时间、大小等），适合需要详细文件信息的场景。

三、LINQ增强查询能力

结合LINQ实现复杂查询和排序：

var recentLargeFiles = new DirectoryInfo(@"C:\MyFolder")
    .GetFiles()
    .Where(f => f.Length > 1024000 && 
           f.LastWriteTime > DateTime.Now.AddDays(-7))
    .OrderByDescending(f => f.Length)
    .Select(f => new {
        f.Name,
        SizeMB = f.Length / (1024 * 1024)
    });

应用场景：需要复杂条件筛选、数据加工或排序时，LINQ能显著提升代码可读性和灵活性。

四、异步获取大目录文件

避免UI线程阻塞的异步实现方案：

async Task<List<string>> GetFilesAsync(string path)
{
    return await Task.Run(() => 
    {
        try {
            return Directory.GetFiles(path).ToList();
        }
        catch (UnauthorizedAccessException) {
            return new List<string>();
        }
    });
}

// 调用示例
var files = await GetFilesAsync(@"C:\LargeFolder");

性能建议：当处理包含数万文件的目录时，异步方法可保持程序响应性，避免界面卡顿。

五、递归获取子目录文件

递归实现多层目录遍历：

static IEnumerable<string> GetAllFiles(string root)
{
    foreach (var file in Directory.GetFiles(root))
        yield return file;
    
    foreach (var dir in Directory.GetDirectories(root))
        foreach (var file in GetAllFiles(dir))
            yield return file;
}

// 使用示例（注意异常处理）
try {
    foreach (var file in GetAllFiles(@"C:\Projects"))
        Console.WriteLine(file);
}
catch (Exception ex) {
    Console.WriteLine($"Error: {ex.Message}");
}

注意事项：深度递归可能导致栈溢出，对于特别深的目录结构建议改用迭代方式。

六、高级文件过滤技巧

实现复杂过滤条件的几种方式：

// 多扩展名过滤
var mediaFiles = Directory.GetFiles(@"C:\Media")
    .Where(f => 
        f.EndsWith(".mp3", StringComparison.OrdinalIgnoreCase) ||
        f.EndsWith(".mp4", StringComparison.OrdinalIgnoreCase));

// 使用枚举限制文件属性
var hiddenFiles = new DirectoryInfo(@"C:\System")
    .GetFiles()
    .Where(f => (f.Attributes & FileAttributes.Hidden) != 0);

// 正则表达式匹配
var pattern = new Regex(@"^report_202\d\d\d\d\.csv$");
var reportFiles = Directory.GetFiles(@"C:\Reports")
    .Where(f => pattern.IsMatch(Path.GetFileName(f)));

七、异常处理与权限管理

健壮的实现应该包含以下保护措施：

try
{
    var files = Directory.EnumerateFiles(@"C:\SecureFolder", "*.*",
        new EnumerationOptions {
            IgnoreInaccessible = true,
            RecurseSubdirectories = true
        });
    
    foreach (var file in files)
    {
        try {
            var info = new FileInfo(file);
            // 处理文件...
        }
        catch (IOException ioEx) {
            LogError($"IO Error with {file}: {ioEx.Message}");
        }
    }
}
catch (UnauthorizedAccessException authEx)
{
    Console.WriteLine($"Access denied: {authEx.Message}");
}
catch (DirectoryNotFoundException dirEx)
{
    Console.WriteLine($"Directory not found: {dirEx.Message}");
}

最佳实践：

• 使用EnumerateFiles而非GetFiles以减少内存占用
• 设置EnumerationOptions控制遍历行为
• 对每文件操作单独try-catch避免整体失败

常见问题解答Q&A

问：GetFiles和EnumerateFiles有何区别？

答：GetFiles一次性返回所有结果的数组，内存消耗较大；EnumerateFiles使用迭代器按需返回，适合大目录。功能相同但性能特性不同。

问：如何提升大目录的遍历速度？

答：1) 使用EnumerateFiles减少内存压力 2) 并行处理（Parallel.ForEach）3) 避免不必要的属性获取 4) 考虑禁用短文件名生成（SetSearchOption）

问：为什么有时会获取到隐藏文件？

答：默认情况下系统API会包含隐藏文件。如需排除，可检查FileAttributes.Hidden属性或设置EnumerationOptions.AttributesToSkip参数。

问：网络路径的文件列表获取有何特殊要求？

答：1) 确保使用UNC路径（\\server\share）2) 程序运行账户需有网络权限 3) 考虑网络延迟增加超时处理 4) 可能需要特殊身份模拟（impersonation）