Java怎么复制整个文件夹及其子文件？代码实现步骤是怎样的？

Java怎么复制文件夹的

在Java开发中，复制文件夹是一个常见的需求，无论是文件备份、数据迁移还是系统功能扩展，都需要高效、稳定的文件夹复制方案，由于文件夹可能包含子文件夹和多层嵌套文件，单纯复制单个文件的方法无法满足需求，本文将详细介绍Java中复制文件夹的多种方法，包括基于传统I/O流的方式、NIO.2的高效实现，以及第三方库的简化方案，同时涵盖异常处理、进度监控等实用技巧。

基于传统I/O流的文件夹复制方法

Java的传统I/O（java.io）包提供了File类和文件流操作，是实现文件夹复制的基础，核心思路是递归遍历源文件夹中的所有文件和子文件夹，逐个创建目标文件夹并复制文件内容，以下是具体步骤：

1. 检查源文件夹是否存在
   使用File.exists()方法验证源文件夹路径是否有效，避免因路径错误导致程序异常。

2. 创建目标文件夹
   通过File.mkdirs()方法递归创建目标文件夹及其父目录，确保目标路径可写入。

3. 递归遍历文件
   使用File.listFiles()获取源文件夹下的所有文件和子文件夹，对每个子文件夹递归调用复制方法，对文件则执行复制操作。

4. 文件复制实现
   通过FileInputStream读取源文件，结合FileOutputStream写入目标文件，使用byte[]缓冲区提高读写效率。

示例代码如下：

import java.io.*;  
public class FolderCopyIO {  
    public static void copyFolder(File src, File dest) throws IOException {  
        if (!src.exists()) {  
            throw new FileNotFoundException("源文件夹不存在");  
        }  
        if (src.isDirectory()) {  
            dest.mkdirs();  
            File[] files = src.listFiles();  
            if (files != null) {  
                for (File file : files) {  
                    copyFolder(file, new File(dest, file.getName()));  
                }  
            }  
        } else {  
            try (InputStream in = new FileInputStream(src);  
                 OutputStream out = new FileOutputStream(dest)) {  
                byte[] buffer = new byte[1024];  
                int length;  
                while ((length = in.read(buffer)) > 0) {  
                    out.write(buffer, 0, length);  
                }  
            }  
        }  
    }  
}  

注意事项：

• 需要处理IOException，确保流资源正确关闭（使用try-with-resources）。
• 大文件复制时，缓冲区大小（如1024字节）可能影响性能，可根据实际调整。

基于NIO.2的高效文件夹复制

Java 7引入的NIO.2（java.nio.file）提供了更高效的文件操作API，特别适合处理大文件和复杂路径，核心类包括Path、Files和FileVisitor，支持批量操作和原子性写入。

1. 使用Files.walk()遍历文件树
   Files.walk()方法可以递归获取所有子路径，返回Stream<Path>，便于流式处理。

2. 复制文件与文件夹

   • 通过Files.createDirectories()创建目标目录。
   • 使用Files.copy()方法复制文件，支持StandardCopyOption选项（如REPLACE_EXISTING覆盖已存在文件）。

示例代码：

import java.io.IOException;  
import java.nio.file.*;  
public class FolderCopyNIO {  
    public static void copyFolder(Path src, Path dest) throws IOException {  
        if (!Files.exists(src)) {  
            throw new FileNotFoundException("源文件夹不存在");  
        }  
        Files.walk(src)  
            .forEach(source -> {  
                Path destination = dest.resolve(src.relativize(source));  
                try {  
                    if (Files.isDirectory(source)) {  
                        Files.createDirectories(destination);  
                    } else {  
                        Files.copy(source, destination, StandardCopyOption.REPLACE_EXISTING);  
                    }  
                } catch (IOException e) {  
                    throw new RuntimeException("复制失败: " + source, e);  
                }  
            });  
    }  
}  

优势：

• 并行处理：通过Files.walk().parallel()实现多线程复制，提升大文件夹效率。
• 原子性操作：StandardCopyOption.ATOMIC_MOVE支持原子性移动，避免数据不一致。

使用Apache Commons IO简化开发

对于追求开发效率的场景，Apache Commons IO库提供了FileUtils工具类，封装了复杂的文件操作逻辑。

1. 添加依赖
   在Maven项目中引入：

   <dependency>  
       <groupId>commons-io</groupId>  
       <artifactId>commons-io</artifactId>  
       <version>2.11.0</version>  
   </dependency>  

2. 调用FileUtils.copyDirectory()

   import org.apache.commons.io.FileUtils;  
   public class FolderCopyCommons {  
       public static void copyFolder(File src, File dest) throws IOException {  
           if (!src.exists()) {  
               throw new FileNotFoundException("源文件夹不存在");  
           }  
           FileUtils.copyDirectory(src, dest);  
       }  
   }  

特点：

• 代码简洁，无需手动处理递归和流操作。
• 内置文件过滤器、进度监听等扩展功能。

异常处理与性能优化

无论采用哪种方法，都需要关注以下细节：

1. 异常处理

   • 捕获IOException，记录错误日志或提示用户。
   • 检查目标文件夹的写入权限，避免AccessDeniedException。

2. 性能优化

   • 缓冲区大小：NIO.2默认使用8KB缓冲区，大文件可适当增大（如8192字节）。
   • 并行流：NIO.2的parallel()方法适合多核CPU环境，但需注意线程安全问题。
   • 进度监控：通过Files.walk()统计文件总数，结合计数器实现进度回调。

3. 特殊场景处理

   • 符号链接：使用Files.copy()的NOFOLLOW_LINKS选项避免复制链接指向的实际文件。
   • 文件属性：通过Files.setAttribute()保留源文件的修改时间、权限等元数据。

Java中复制文件夹的方法多种多样，开发者可根据需求选择：

• 传统I/O：适合简单场景，代码直观但性能较低。
• NIO.2：推荐用于生产环境，支持高效、并行操作。
• 第三方库：适合快速开发，减少重复编码。

无论选择哪种方式，都需确保异常处理的健壮性和性能调优的针对性，以实现稳定、高效的文件夹复制功能。