Java文件拷贝工具实现与IO流实战解析

推荐直接用 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，不能只靠 finally 中 close()
• BufferedOutputStream 的 write() 不保证立即落盘，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 是 FileChannel（FileInputStream.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() 里手动控制。