使用 files.copy() 复制文件时,默认行为是如果目标文件已存在则抛出 filealreadyexistsexception。要避免覆盖并实现静默跳过或替换,需要传入 standardcopyoption.replace_existing 枚举值来允许覆盖,或者不传该选项并在调用前检查文件是否存在以决定跳过。通常开发者希望的是“不存在则复制,存在则跳过”,这可以通过 files.exists() 判断结合异常处理来实现。

如何判断目标文件是否存在以避免覆盖?
在调用 Files.copy() 之前,先使用 Files.exists(targetPath) 检查目标路径。如果返回 true,说明文件已存在,此时直接跳过复制操作即可避免覆盖;如果返回 false,则执行复制。这种方法最安全,因为它完全由代码逻辑控制是否写入磁盘,不会触发任何异常。

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class FileCopyExample {
public static void main(String[] args) throws Exception {
Path source = Paths.get("source.txt");
Path target = Paths.get("target.txt");
// 核心逻辑:先检查是否存在
if (!Files.exists(target)) {
Files.copy(source, target);
System.out.println("File copied successfully.");
} else {
System.out.println("Target file already exists. Skipping copy.");
}
}
}
如何使用 REPLACE_EXISTING 选项强制覆盖?
如果业务需求是“无论是否存在都覆盖”,则需要在 Files.copy() 的第三个参数位置传入 StandardCopyOption.REPLACE_EXISTING。这样即使目标文件存在,也会被新内容替换,而不会抛出异常。这是 Files.copy() 提供的标准覆盖机制,适用于需要更新最新文件的场景。
立即学习“Java免费学习笔记(深入)”;

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
public class FileOverwriteExample {
public static void main(String[] args) throws Exception {
Path source = Paths.get("source.txt");
Path target = Paths.get("target.txt");
// 核心逻辑:强制覆盖
Files.copy(source, target, StandardCopyOption.REPLACE_EXISTING);
System.out.println("File overwritten successfully.");
}
}
当源文件为空时会发生什么?
如果源文件是一个空文件(大小为0),Files.copy() 会成功创建一个同样大小的空目标文件。它不会报错,也不会跳过,而是正常完成复制操作。这意味着你的“存在性检查”逻辑依然有效:如果目标已存在且为空,按第一种方法会跳过;如果使用了 REPLACE_EXISTING,则会保留目标原有的状态(如果是空的则保持空)或被新的空文件覆盖(结果相同)。对于非空文件,复制会完整传输字节流。


















