C#中如何完整复制文件夹及其内部所有文件？两种实用方案详解

在日常的C#开发工作中，复制文件夹及其内部所有文件是一项极为常见的操作。无论是做本地数据备份、发布应用程序的资源文件、迁移用户数据目录，还是同步配置文件，都需要将整个目录树完整无误地复制到目标位置。这项操作看似简单，但如果目录层级很深、文件数量庞大，或者需要在复制过程中按条件过滤文件、记录日志，就必须选用一种既可靠又灵活的方案。本文将围绕这一需求，详细介绍两种主流的实现方式，分析它们的适用场景，并重点讲解容易被忽略的边界问题和健壮性处理技巧。

一、使用系统自带方法快速完成目录复制

1.1 认识FileSystem.CopyDirectory

在.NET平台中，微软提供了一个非常便捷的方法来复制整个目录，那就是位于Microsoft.VisualBasic.FileIO命名空间下的FileSystem.CopyDirectory。虽然这个命名空间最初是为Visual Basic设计的，但在C#项目中同样可以正常引用和使用。开发者只需要在项目中添加对Microsoft.VisualBasic程序集的引用，然后在代码文件顶部引入对应的命名空间即可。

这个方法的设计初衷就是为了简化目录复制操作。调用时，你需要传入三个参数：源目录路径、目标目录路径，以及一个布尔值用于指示是否覆盖目标位置已有的文件。当第三个参数为true时，如果目标目录下已经存在同名文件或子文件夹，它们会被直接覆盖；如果为false，则会抛出异常，或者根据具体实现跳过已有内容（不同.NET版本的行为略有差异，建议查阅官方文档）。

1.2 实际代码示例

下面是一个封装好的静态方法，展示了如何使用FileSystem.CopyDirectory来实现目录复制：

using Microsoft.VisualBasic.FileIO;

public static void CopyFolderBySystem(string sourcePath, string targetPath)
{
    // 检查源文件夹是否存在
    if (!Directory.Exists(sourcePath))
    {
        throw new DirectoryNotFoundException($"源文件夹不存在: {sourcePath}");
    }

    // 第三个参数表示目标路径已存在时是否覆盖
    FileSystem.CopyDirectory(sourcePath, targetPath, true);
}

这段代码非常简洁：首先判断源目录是否存在，如果不存在则抛出明确的异常；然后直接调用CopyDirectory方法，第三个参数设为true，表示覆盖所有已存在的文件。整个复制过程由底层框架自动完成，不需要开发者手动遍历目录树。

1.3 这种方式的优缺点

优点非常突出：代码量极少，执行效率高，底层实现经过了充分优化，尤其在处理大量小文件时表现稳定。而且不需要自己编写递归逻辑，降低了出错概率。

缺点也比较明显：首先，它依赖于Microsoft.VisualBasic命名空间。对于一些坚持“纯C#”风格的项目，或者对依赖管理非常严格的团队，引入这个程序集可能会引起争议。其次，这个方法不支持在复制过程中插入自定义逻辑，比如按文件类型过滤、记录复制进度、写入日志等。因此，它最适合那些“无需任何额外干预，只要把整个目录搬过去就行”的场景，例如一次性备份、部署静态资源等。

二、使用递归方式自主实现目录拷贝

2.1 递归方案的核心思想

如果你不希望引入Microsoft.VisualBasic依赖，或者需要在复制过程中加入自定义逻辑（比如只复制特定类型的文件、显示进度条、记录错误日志），那么自己动手实现递归复制是最好的选择。递归方案的核心思路很简单：先处理当前目录，再深入处理所有子目录。具体来说，分为三步：

1. 创建目标目录（如果不存在）。
2. 复制当前目录下的所有文件。
3. 对当前目录下的每一个子目录，重复执行上述步骤。

这种实现方式完全基于System.IO命名空间，不引入任何额外程序集，因此具有极佳的兼容性和可控性。

2.2 基础递归复制代码

下面是一个基本的递归复制方法，参数包括源目录、目标目录和一个覆盖标志：

public static void CopyDirectoryRecursively(string sourceDir, string targetDir, bool overwrite = true)
{
    // 检查源文件夹是否存在
    if (!Directory.Exists(sourceDir))
    {
        throw new DirectoryNotFoundException($"源文件夹不存在: {sourceDir}");
    }

    // 创建目标文件夹根目录
    Directory.CreateDirectory(targetDir);

    // 复制当前目录下的所有文件
    foreach (string file in Directory.GetFiles(sourceDir))
    {
        string fileName = Path.GetFileName(file);
        string destFile = Path.Combine(targetDir, fileName);
        File.Copy(file, destFile, overwrite);
    }

    // 递归处理所有子文件夹
    foreach (string subDir in Directory.GetDirectories(sourceDir))
    {
        string dirName = Path.GetFileName(subDir);
        string destSubDir = Path.Combine(targetDir, dirName);
        CopyDirectoryRecursively(subDir, destSubDir, overwrite);
    }
}

让我们逐行理解这段代码：

• 首先检查源目录是否存在，避免在无效路径上继续执行。
• 使用Directory.CreateDirectory(targetDir)创建目标根目录。这个方法有一个很好的特性：如果目录已经存在，它不会报错，而是直接返回。因此我们不需要事先判断目标目录是否已创建。
• 接着通过Directory.GetFiles(sourceDir)获取当前目录下的所有文件路径。对于每个文件，我们用Path.GetFileName提取文件名，再用Path.Combine拼接出目标路径，最后调用File.Copy进行复制。
• 然后通过Directory.GetDirectories(sourceDir)获取所有子目录路径，对每个子目录递归调用自身。由于每次递归都会先创建对应的目标子目录，因此即使目录嵌套几十层，也能正确复制。

2.3 在递归中加入文件过滤

递归方案最大的优势在于灵活性。假如你只想复制扩展名为.txt的文本文件，或者排除名为temp的临时目录，都可以轻松实现。下面演示如何按文件扩展名过滤：

foreach (string file in Directory.GetFiles(sourceDir))
{
    string extension = Path.GetExtension(file);
    // 只复制 txt 文件，其他文件跳过
    if (!string.Equals(extension, ".txt", StringComparison.OrdinalIgnoreCase))
    {
        continue;
    }

    string targetFile = Path.Combine(targetDir, Path.GetFileName(file));
    File.Copy(file, targetFile, overwrite);
}

同理，如果你想排除某个子目录，可以在递归循环中加入判断：

foreach (string subDir in Directory.GetDirectories(sourceDir))
{
    string dirName = Path.GetFileName(subDir);
    // 跳过名为 "cache" 的目录
    if (string.Equals(dirName, "cache", StringComparison.OrdinalIgnoreCase))
    {
        continue;
    }
    string destSubDir = Path.Combine(targetDir, dirName);
    CopyDirectoryRecursively(subDir, destSubDir, overwrite);
}

这种按需过滤的能力，使得递归方案非常适合需要定制化复制的场景，比如只同步配置文件、只备份用户数据、忽略临时生成的文件等。

三、两种实现方式的对比

选择哪一种实现方式，主要取决于项目对依赖、灵活性和可控性的要求。为了帮助开发者快速决策，下面通过一个表格进行直观对比：

在实际项目中，如果你只是做一个临时的备份工具，或者执行一次性的目录迁移，那么使用FileSystem.CopyDirectory会更直接、更省力。但如果你开发的是一款需要长期维护的应用，并且复制操作是其中的核心功能，那么自己实现递归复制会让代码更具可控性和扩展性。

四、注意事项与健壮性处理

4.1 源目录存在性检查

无论使用哪种方法，第一步都应该检查源目录是否存在。如果源路径指向一个不存在的文件夹，直接进行复制操作会抛出DirectoryNotFoundException。建议在方法入口处显式判断，并给出清晰的错误提示，而不是让异常冒泡到上层调用者。

4.2 防止目标目录成为源目录的子目录

这是一个非常隐蔽但后果严重的陷阱。如果目标目录恰好位于源目录的内部（例如源目录是C:\Data，目标目录是C:\Data\Backup），那么在递归复制时，程序会先创建C:\Data\Backup，然后继续遍历源目录时，又会发现Backup子目录，从而再次复制……如此循环，最终导致无限递归，引发栈溢出或磁盘空间耗尽。

为了避免这个问题，可以在复制前进行路径规范化判断。使用Path.GetFullPath将源目录和目标目录都转换为完整路径，然后检查目标完整路径是否以“源完整路径加目录分隔符”开头。这种方式比简单的字符串比较更加可靠，能够避免诸如C:\data和C:\database之间的误判。

public static void CopyDirectoryWithCheck(string sourceDir, string targetDir, bool overwrite = true)
{
    if (!Directory.Exists(sourceDir))
    {
        throw new DirectoryNotFoundException($"源文件夹不存在: {sourceDir}");
    }

    // 规范化路径，避免目标路径是源路径的子文件夹
    string fullSource = Path.GetFullPath(sourceDir);
    string fullTarget = Path.GetFullPath(targetDir);
    string sourceRoot = fullSource.TrimEnd(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar) + Path.DirectorySeparatorChar;

    if (fullTarget.StartsWith(sourceRoot, StringComparison.OrdinalIgnoreCase))
    {
        throw new InvalidOperationException("目标路径不能是源路径的子文件夹");
    }

    CopyDirectoryRecursively(sourceDir, targetDir, overwrite);
}

4.3 异常处理与日志记录

复制大量文件时，难免会遇到各种意外情况：源文件被其他进程占用、目标磁盘空间不足、权限不够等。这些错误会在File.Copy或Directory.CreateDirectory执行时抛出IOException或UnauthorizedAccessException。建议在最外层使用try-catch捕获这些异常，并根据业务需求决定是终止整个复制过程，还是跳过失败文件继续执行。

下面是一个简单的异常处理骨架：

try
{
    CopyDirectoryWithCheck(sourceDir, targetDir, true);
    Console.WriteLine("目录复制完成");
}
catch (Exception ex)
{
    Console.WriteLine($"复制失败: {ex.Message}");
    // 可以在此处记录日志或执行清理操作
}

如果需要更精细的控制，可以在递归循环内逐个文件进行 try-catch，并将失败的文件路径记录下来，以便后续重试或人工处理。

4.4 长路径与符号链接的处理

在 Windows 系统中，文件路径长度超过 260 个字符时会触发PathTooLongException。从 .NET Framework 4.6.2 开始，可以通过配置app.config启用长路径支持，或者使用 `\?` 前缀。在递归复制时，建议考虑这一点，尤其是当源目录包含深层嵌套时。

另外，如果源目录中包含符号链接（Symbolic Link），Directory.GetDirectories默认会跟随链接进入实际目录，这可能导致意外的复制范围。如果需要忽略符号链接，可以使用Directory.EnumerateDirectories配合EnumerationOptions参数进行控制。

五、总结

C# 中复制文件夹及其内部所有文件并不复杂，关键在于根据实际需求选择合适的方案。如果你追求快速实现且不需要自定义逻辑，FileSystem.CopyDirectory是最佳选择；如果你需要细粒度控制、文件过滤或进度反馈，递归实现无疑更胜一筹。无论采用哪种方式，都应当做好源目录存在性检查、目标路径合法性验证以及完善的异常处理，这样才能保证复制过程稳定可靠。

掌握了这些基础技巧后，你还可以进一步扩展：例如加入多线程复制以提高速度、实现异步进度回调以改善用户体验、或者设计可配置的覆盖策略。希望本文能帮助你在实际开发中游刃有余地处理目录复制任务。

C#目录拷贝文件复制递归遍历DirectoryInfo修改时间：2026-08-23 06:20:11