在Java中如何实现文件拷贝工具_JavaIO流实战案例解析

推荐直接用 Files.copy(),它底层自动选择最优通道,比手写流更快更安全;需显式指定 REPLACE_EXISTING 避免异常,并注意符号链接处理。

Files.copy() 最快最安全

Java 7+ 推荐直接用 Files.copy(),它底层自动选择最优通道(如 FileChannel 或零拷贝系统调用),比手写 BufferedInputStream + BufferedOutputStream 更快、更少出错。

常见错误是

忽略 StandardCopyOption.REPLACE_EXISTING 导致目标文件已存在时抛 FileAlreadyExistsException;还有忘记处理符号链接(默认会复制链接本身,不是目标内容)。

  • 必须显式指定 StandardCopyOption.REPLACE_EXISTING 才能覆盖
  • 若需跟随符号链接,加 StandardCopyOption.COPY_ATTRIBUTES 不够,得先用 Files.readSymbolicLink() 判断再处理
  • 大文件(>1GB)下,Files.copy() 仍可能触发 GC 压力,此时可考虑分块 transferTo()
Path source = Paths.get("a.txt");
Path target = Paths.get("b.txt");
try {
    Files.copy(source, target, StandardCopyOption.REPLACE_EXISTING);
} catch (IOException e) {
    // 处理权限不足、磁盘满等
}

手动流拷贝时别漏掉 flush()close()

FileInputStream / FileOutputStream 配合 BufferedInputStream / BufferedOutputStream 是 Java 6 兼容方案,但极易因忘记 flush() 或异常路径下未 close() 导致数据截断或句柄泄漏。

缓冲区大小不是越大越好:设为 8192(8KB)是多数场景的平衡点;超过 64KB 可能反而降低小文件性能(内存预分配开销)。

  • 必须用 try-with-resources,不能只靠 finallyclose()
  • BufferedOutputStreamwrite() 不保证立即落盘,flush() 必须在 close() 前显式调用(虽然 close() 会隐式 flush,但异常中断时可能跳过)
  • 避免用 available() 判断 EOF——它返回的是“当前可无阻塞读取的字节数”,不是文件总长
try (InputStream in = new BufferedInputStream(new FileInputStream("src"));
     OutputStream out = new BufferedOutputStream(new FileOutputStream("dst"))) {
    byte[] buf = new byte[8192];
    int len;
    while ((len = in.read(buf)) != -1) {
        out.write(buf, 0, len);
    }
    out.flush(); // 显式 flush 更稳妥
}

FileChannel.transferTo() 适合超大文件但有平台限制

当拷贝 >500MB 文件且需要极致性能时,FileChannel.transferTo() 可利用操作系统零拷贝能力(如 Linux 的 sendfile),绕过 JVM 堆内存,大幅减少 CPU 和 GC 开销。

但它有两个硬伤:Windows 下单次 transfer 不能超过 2GB(int 参数限制),且某些旧版 JDK 在 ext4 文件系统上对稀疏文件支持不完整,可能拷出全零填充。

  • 必须确保源 channel 是 FileChannelFileInputStream.getChannel()),目标 channel 也得是 FileChannel
  • 循环调用 transferTo(),每次传最多 Integer.MAX_VALUE 字节(约 2GB)
  • 不能用于网络 socket 输出流——transferTo() 第二参数只接受 WritableByteChannel,而 socket channel 不一定支持
try (FileChannel in = new FileInputStream("src").getChannel();
     FileChannel out = new FileOutputStream("dst").getChannel()) {
    long pos = 0;
    long count = in.size();
    while (pos < count) {
        pos += in.transferTo(pos, Math.min(count - pos, Integer.MAX_VALUE), out);
    }
}

复制目录不能只靠 Files.copy()

Files.copy() 默认只处理单个文件,对目录会直接抛 IOException(提示 “Is a directory”)。递归复制目录必须自己遍历,且要注意:符号链接、权限位、最后修改时间这些元数据不会自动继承。

最容易被忽略的是 Windows 下的只读文件——Files.copy() 失败后,目标目录可能已建好但里面空空如也,后续逻辑误判为“复制成功”。

  • Files.walkFileTree() 配合 SimpleFileVisitor 是标准解法
  • 复制前先用 Files.setAttribute() 设置目标目录权限("posix:permissions""dos:readonly"
  • Files.getLastModifiedTime()Files.setLastModifiedTime() 同步时间戳

复杂点在于:有些场景要跳过特定子目录(如 .git),有些要保留硬链接一致性——这些都得在 visitFile()preVisitDirectory() 里手动控制。