在Java中如何实现文件复制工具_Java文件操作项目实战_技术教程

Files.copy() 是 Java 7+ 复制文件最可靠方式，支持多种源/目标类型，默认不覆盖需显式指定 REPLACE_EXISTING；目录递归需配合 Files.walkFileTree() 和自定义 SimpleFileVisitor。

Java标准库本身不提供直接的“复制文件”高层API，Files.copy() 是最可靠、最推荐的方式，它底层自动处理流关闭、缓冲、权限继承等细节，比手写 FileInputStream/FileOutputStream 更安全且不易出错。

用 `Files.copy()` 完成单文件复制

这是 JDK 7+ 的标准做法，支持多种源/目标类型（Path、InputStream、OutputStream），默认会拒绝覆盖已存在文件，需显式传入 StandardCopyOption.REPLACE_EXISTING。

import java.io.IOException;
import java.nio.file.*;

Path source = Paths.get("data/input.txt");
Path target = Paths.get("backup/input.txt");

try {
    Files.copy(source, target, StandardCopyOption.REPLACE_EXISTING);
} catch (IOException e) {
    System.err.println("复制失败：" + e.getMessage());
}

必须确保目标目录已存在，否则抛 java.nio.file.NoSuchFileException；可用 Files.createDirectories(target.getParent()) 预创建
若源是符号链接，默认复制的是链接本身（不是链接指向的内容）；加 LinkOption.NOFOLLOW_LINKS 可改变行为
不会自动继承所有文件属性（如 Linux 下的执行权限），需额外调用 Files.setPosixFilePermissions() 或使用 copyAttributes 选项

Files.copy() 不支持目录递归，必须手动遍历。推荐用 Files.walkFileTree() 配合自定义 SimpleFileVisitor，它能正确处理符号链接、权限、异常中断等边界情况。

import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;

public class DirCopyVisitor extends SimpleFileVisitor
 {
    private final Path sourceRoot;
    private final Path targetRoot;

    public DirCopyVisitor(Path sourceRoot, Path targetRoot) {
        this.sourceRoot = sourceRoot;
        this.targetRoot = targetRoot;
    }

    @Override
    public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) throws IOException {
        Path targetDir = targetRoot.resolve(sourceRoot.relativize(dir));
        Files.createDirectories(targetDir);
        return FileVisitResult.CONTINUE;
    }

    @Override
    public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
        Path targetFile = targetRoot.resolve(sourceRoot.relativize(file));
        Files.copy(file, targetFile, StandardCopyOption.REPLACE_EXISTING);
        return FileVisitResult.CONTINUE;
    }
}

// 使用示例：
Files.walkFileTree(Paths.get("src"), new DirCopyVisitor(Paths.get("src"), Paths.get("dst")));

不要用 Files.list() + 递归调用，它不保证访问顺序，也无法优雅跳过无法读取的子目录（如权限不足）
visitFileFailed() 方法必须重写并返回 CONTINUE，否则遇到不可读目录会中止整个遍历
若需保留最后修改时间，可在 visitFile 中调用 Files.setLastModifiedTime(targetFile, Files.getLastModifiedTime(file))

避免常见陷阱：权限、中文路径与大文件

Java 文件操作在不同系统上表现不一致，尤其涉及权限和编码时容易静默失败。

Windows 下用 Files.copy() 复制带只读属性的文件会失败，需先 Files.setAttribute(path, "dos:readonly", false)
Linux/macOS 上若目标文件已有执行权限，但 copy() 默认不复制 POSIX 权限，结果文件可能不可执行——需显式调用 Files.copy(source, target, StandardCopyOption.COPY_ATTRIBUTES)
路径含中文或特殊字符时，只要用 Paths.get() 构造 Path（而非字符串拼接），JVM 会自动处理编码，无需手动转义
复制超大文件（>2GB）时，Files.copy() 内部使用堆外内存和零拷贝优化，性能优于手动 BufferedInputStream，无需额外分块逻辑