Java文件复制工具实现与实战教程

本文深入解析了Java中文件复制的核心实践，重点介绍了JDK 7+推荐的Files.copy()方法在单文件复制中的高效与安全特性，并系统讲解了如何结合Files.walkFileTree()与自定义SimpleFileVisitor实现健壮的目录递归复制；同时直击开发痛点，详解权限处理（如Windows只读属性、Linux执行权限缺失）、中文路径兼容、大文件优化等真实场景陷阱，强调真正决定代码质量的不是基础语法，而是对COPY_ATTRIBUTES、REPLACE_EXISTING、目录预创建、异常恢复等关键细节的精准把控——帮你写出在生产环境稳定运行、错误可追溯、跨平台可靠的文件操作逻辑。

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，无需额外分块逻辑

真正难的不是“怎么写”，而是判断什么时候该用 COPY_ATTRIBUTES、什么时候要预检查父目录、以及如何让错误信息足够明确以便定位是权限问题还是路径不存在——这些细节往往在测试环境里才暴露出来。

本篇关于《Java文件复制工具实现与实战教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！