Java实现文件移动时目标目录存在同名文件自动重命名的方法

直接用Java NIO.2（Java 7及以上内置，无需引入第三方依赖）实现即可，不要依赖旧的java.io.File#renameTo方法，该方法在不同文件系统、不同操作系统下行为不一致，经常出现移动失败无明确报错的问题。

核心实现逻辑 #

• 移动前先做基础校验：确认源文件存在且为普通文件，目标目录不存在则递归创建
• 首次尝试直接匹配目标路径，若路径下无同名文件直接移动
• 若存在同名文件，按「文件名(递增序号).扩展名」的规则迭代生成新文件名，直到找到目标目录下不存在的文件名
• 最终使用NIO的移动接口完成文件转移，全程不覆盖已有文件

可直接复用的实现代码 #

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;

public class FileMoveUtil {

    /**
     * 移动文件，目标目录存在同名时自动重命名
     * @param sourcePath 源文件路径
     * @param targetDir  目标目录路径
     * @return 最终移动完成的文件路径
     * @throws IOException 文件读写异常
     */
    public static Path moveWithAutoRename(String sourcePath, String targetDir) throws IOException {
        Path source = Paths.get(sourcePath);
        // 基础校验：源文件必须存在且是普通文件
        if (!Files.exists(source) || !Files.isRegularFile(source)) {
            throw new IllegalArgumentException("源文件不存在或不是有效文件：" + sourcePath);
        }
        // 目标目录不存在则递归创建
        Path targetDirPath = Paths.get(targetDir);
        if (!Files.exists(targetDirPath)) {
            Files.createDirectories(targetDirPath);
        }

        // 解析原文件名、后缀，兼容无后缀、.开头的隐藏文件场景
        String originalFileName = source.getFileName().toString();
        String baseName = originalFileName;
        String extension = "";
        int dotIndex = originalFileName.lastIndexOf('.');
        if (dotIndex > 0) {
            baseName = originalFileName.substring(0, dotIndex);
            extension = originalFileName.substring(dotIndex);
        }

        // 先尝试原始文件名
        Path targetPath = targetDirPath.resolve(originalFileName);
        int counter = 1;
        // 循环找到不重名的可用路径
        while (Files.exists(targetPath)) {
            String newFileName = String.format("%s(%d)%s", baseName, counter, extension);
            targetPath = targetDirPath.resolve(newFileName);
            counter++;
        }

        // 执行移动，跨文件系统移动如果报原子移动不支持的错误，直接去掉ATOMIC_MOVE参数即可
        return Files.move(source, targetPath, StandardCopyOption.ATOMIC_MOVE);
    }

    // 功能测试
    public static void main(String[] args) throws IOException {
        Path finalPath = moveWithAutoRename("D:/test.txt", "E:/archive");
        System.out.println("文件移动完成，最终存储路径：" + finalPath);
    }
}

落地注意事项 #

• 上述代码用的是Windows、macOS系统自带文件管理器默认的同名重命名规则，普通用户接受度最高，也可以根据自己的需求改成加时间戳、随机串的重命名逻辑
• 不要在重名校验和实际移动之间加多余的耗时操作，避免极端情况下刚好有其他程序在你校验完、移动前创建了同名文件导致报错，对可靠性要求极高的场景，可以加1-2次重试逻辑
• 如果需要移动目录而非单个文件，只需要在现有逻辑外层加一层文件树遍历，逐个处理目录下的文件即可

内容的提问来源于stack exchange，提问作者Leohtcg