在C#开发中，复制文件夹及内部所有文件是常见的文件操作需求，无论是做数据备份、项目部署还是文件迁移，都可能需要用到这个功能。实现这个需求的方式有多种，开发者可以根据实际场景选择合适的方法。
使用系统自带方法快速拷贝
如果不需要自定义拷贝的额外逻辑，比如不需要过滤特定文件、不需要处理拷贝进度，那么可以直接使用DirectoryInfo类提供的CreateSubdirectory配合文件复制方法，或者使用更简洁的扩展思路。不过更推荐的是使用FileSystem.CopyDirectory方法，不过需要注意这个方法是Microsoft.VisualBasic命名空间下的，需要添加对应引用。
首先需要在项目中添加对Microsoft.VisualBasic的引用，然后引入命名空间：
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);
}
这个方法的第三个参数表示如果目标路径已存在是否覆盖，设置为true就会覆盖已有的文件和文件夹。这种方式的优点是代码量少，执行效率高，系统底层做了很多优化，缺点是依赖VisualBasic的命名空间，部分纯C#项目可能不希望引入这个依赖。
自定义递归实现目录拷贝
如果不想依赖其他命名空间，完全可以通过递归遍历文件夹的方式自己实现拷贝逻辑，这种方式可以灵活控制拷贝过程，比如过滤特定后缀的文件、记录拷贝的文件数量等。
实现思路
核心逻辑分为三步：
- 先创建目标文件夹的根目录，如果目标目录不存在就新建
- 遍历源文件夹下的所有文件，逐个复制到目标文件夹的对应路径
- 遍历源文件夹下的所有子文件夹，递归调用拷贝方法，处理子文件夹的内容
完整代码实现
using System;
using System.IO;
public static class DirectoryCopyHelper
{
/// <summary>
/// 递归拷贝文件夹及所有内容
/// </summary>
/// <param name="sourceDir">源文件夹路径</param>
/// <param name="targetDir">目标文件夹路径</param>
/// <param name="overwrite">是否覆盖已存在的文件</param>
public static void CopyDirectory(string sourceDir, string targetDir, bool overwrite = true)
{
// 获取源文件夹的DirectoryInfo对象
DirectoryInfo sourceDirInfo = new DirectoryInfo(sourceDir);
// 检查源文件夹是否存在
if (!sourceDirInfo.Exists)
{
throw new DirectoryNotFoundException($"源文件夹不存在: {sourceDir}");
}
// 创建目标文件夹根目录
DirectoryInfo targetDirInfo = new DirectoryInfo(targetDir);
if (!targetDirInfo.Exists)
{
targetDirInfo.Create();
}
// 拷贝当前目录下的所有文件
foreach (FileInfo file in sourceDirInfo.GetFiles())
{
string targetFilePath = Path.Combine(targetDir, file.Name);
file.CopyTo(targetFilePath, overwrite);
}
// 递归拷贝所有子文件夹
foreach (DirectoryInfo subDir in sourceDirInfo.GetDirectories())
{
string targetSubDirPath = Path.Combine(targetDir, subDir.Name);
CopyDirectory(subDir.FullName, targetSubDirPath, overwrite);
}
}
}
代码说明
上面的代码首先通过DirectoryInfo获取源文件夹的信息，然后创建目标文件夹的根目录。接着遍历源文件夹下的所有文件，使用FileInfo.CopyTo方法复制到目标路径，最后遍历所有子文件夹，递归调用CopyDirectory方法，实现整个目录树的拷贝。
如果需要过滤特定文件，可以在遍历文件的循环中添加判断逻辑，比如只拷贝txt文件：
foreach (FileInfo file in sourceDirInfo.GetFiles())
{
// 只拷贝txt后缀的文件
if (file.Extension.Equals(".txt", StringComparison.OrdinalIgnoreCase))
{
string targetFilePath = Path.Combine(targetDir, file.Name);
file.CopyTo(targetFilePath, overwrite);
}
}
两种方式的对比
为了更清晰地选择实现方式，下面是两种方式的对比：
| 实现方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 系统自带方法 | 代码量少，执行效率高，无需自己处理递归逻辑 | 依赖Microsoft.VisualBasic命名空间 | 无自定义需求，追求快速实现 |
| 自定义递归实现 | 无额外依赖，可灵活控制拷贝逻辑，支持自定义过滤规则 | 代码量稍多，需要自己处理递归边界情况 | 需要过滤文件、记录拷贝过程等自定义场景 |
注意事项
在实际使用过程中，需要注意以下几点：
- 拷贝前一定要检查源文件夹是否存在，避免抛出不必要的异常
- 如果目标路径是源路径的子文件夹，会导致无限递归，需要在代码中添加校验逻辑，禁止这种操作
- 拷贝大文件或者大量文件时，建议添加异常处理，避免中途出错导致部分文件拷贝失败
- 如果是在跨磁盘拷贝，要注意磁盘空间是否充足，避免拷贝过程中出现异常
添加源路径和目标路径校验的示例代码如下：
public static void CopyDirectoryWithCheck(string sourceDir, string targetDir, bool overwrite = true)
{
// 检查源文件夹是否存在
if (!Directory.Exists(sourceDir))
{
throw new DirectoryNotFoundException($"源文件夹不存在: {sourceDir}");
}
// 检查目标路径是否是源路径的子文件夹
if (targetDir.StartsWith(sourceDir, StringComparison.OrdinalIgnoreCase))
{
throw new InvalidOperationException("目标路径不能是源路径的子文件夹");
}
// 调用拷贝方法
CopyDirectory(sourceDir, targetDir, overwrite);
}
C#目录拷贝文件复制递归遍历DirectoryInfo修改时间：2026-07-23 21:27:37