推荐直接用 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 可能反而降低小文件性能(内存预分配开销)。
立即学习“Java免费学习笔记(深入)”;
- 必须用 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() 里手动控制。









