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 文件操作在不同系统上表现不一致，尤其涉及权限和编码时容易静默失败。
立即学习“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、什么时候要预检查父目录、以及如何让错误信息足够明确以便定位是权限问题还是路径不存在——这些细节往往在测试环境里才暴露出来。
