使用Java File.renameTo()重命名含子目录的文件夹失败问题

我一眼就看到了你的代码里最关键的问题——替换规则和目标文件名完全不匹配！你要处理的是小写popcorn-开头的文件/目录，但代码里用的是origName.replaceAll("POPCORN.", "")，这根本匹配不到你的文件名（比如popcorn-subfolder里没有大写的POPCORN.），导致新名字和原名字一模一样，renameTo()当然会返回false——你总不能把一个文件重命名成它自己吧？

除此之外，还有几个小问题会影响递归重命名的稳定性，我帮你把这些问题都修正了，下面是完整的解决方案：

核心问题分析 #

1. 匹配规则错误：目标文件名是popcorn-前缀（小写），但替换时用了大写的POPCORN.，导致新名字无变化，重命名操作无效。
2. 路径拼接不安全：手动拼接路径字符串可能在不同系统（比如Windows/Linux）出现问题，应该用File类的构造函数来处理。
3. 未处理listFiles()返回null的情况：如果传入的base不是目录，或者没有访问权限，listFiles()会返回null，直接遍历会抛出NullPointerException。
4. 递归逻辑的小瑕疵：重命名成功后才应该用新的文件对象进行递归，否则继续用原对象。

修正后的代码 #

public static void renameDirectory(File base) throws IOException {
    // 先判断base是否是有效目录
    if (base == null || !base.isDirectory()) {
        System.out.println("Invalid directory: " + (base != null ? base.getAbsolutePath() : "null"));
        return;
    }

    File[] files = base.listFiles();
    // 处理listFiles返回null的情况（比如权限不足）
    if (files == null) {
        System.out.println("Cannot access directory: " + base.getAbsolutePath());
        return;
    }

    int count = 0;
    for (File file : files) {
        String origName = file.getName();
        File resultFile = file;

        // 匹配开头的popcorn-前缀（需要不区分大小写的话可以用origName.toLowerCase().startsWith("popcorn-")）
        if (origName.startsWith("popcorn-")) {
            System.out.println("Original name -> " + origName);
            // 替换开头的popcorn-前缀为空，得到新名字
            String newName = origName.replaceFirst("^popcorn-", "");
            System.out.println("New name -> " + newName);
            
            // 用File构造函数创建新路径，避免手动拼接的跨平台问题
            File newFile = new File(file.getParentFile(), newName);
            
            // 执行重命名并检查结果
            boolean renamed = file.renameTo(newFile);
            System.out.println("Renamed " + origName + " to " + newName + ": " + renamed);
            
            if (renamed) {
                count++;
                resultFile = newFile;
            } else {
                // 重命名失败时输出详细信息，方便排查
                System.out.println("Failed to rename: " + file.getAbsolutePath() + " -> " + newFile.getAbsolutePath());
            }
        }

        // 如果是目录，递归处理子目录
        if (resultFile.isDirectory()) {
            System.out.println("Entering directory: " + resultFile.getAbsolutePath());
            renameDirectory(resultFile);
        }
    }
    System.out.println("Total renamed items in " + base.getAbsolutePath() + ": " + count);
}

关键改进点说明 #

• 精准匹配前缀：用startsWith("popcorn-")判断目标文件，再用replaceFirst("^popcorn-", "")只替换开头的前缀，避免误替换文件名中间出现的popcorn-。如果需要不区分大小写匹配，可以把判断改成origName.toLowerCase().startsWith("popcorn-")，替换改成replaceFirst("(?i)^popcorn-", "")。
• 安全的路径处理：new File(file.getParentFile(), newName)会自动根据操作系统使用正确的路径分隔符，比手动拼接baseLoc+File.separator+newName更可靠。
• 错误处理：增加了对无效目录、无法访问目录的判断，重命名失败时输出详细路径，方便排查权限或文件占用等问题。
• 递归逻辑优化：只有重命名成功时，才用新的文件对象进行递归，确保后续操作都是针对重命名后的目录。

额外排查建议 #

如果重命名还是失败，你可以从这几个方向排查：

• 文件/目录是否被占用：比如有其他程序正在打开该文件或目录，导致无法重命名。
• 权限问题：当前程序是否有修改该文件/目录的权限？
• 目标路径是否已存在：比如你要重命名成的subfolder已经存在，这时候renameTo()也会返回false。

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