目录遍历与文件内容替换工具-Java代码

概述

本文档介绍了一个用于遍历目录结构、重命名文件并修改文件内容的Java工具。该工具主要用于批量替换文件名和文件内容中的特定字符串，适用于项目重构、代码迁移或大规模重命名场景。

功能特性

1. 目录遍历​：递归遍历指定目录及其所有子目录

2. 文件重命名​：将文件名中的"RedPacket"替换为"Points"

3. 内容替换​：修改文件内容中的"RedPacket"为"Points"

4. 安全验证​：检查目录是否存在及是否可访问

5. 层级显示​：以缩进方式展示目录结构层级关系

6. 日志输出​：提供详细的操作日志和错误信息

适用场景

• 项目重构时的批量重命名

• 代码库中特定术语的大规模替换

• 包名、类名或资源文件的统一修改

• 项目迁移过程中的术语调整

核心代码解析

主入口方法

public static void main(String[] args) {
    System.out.println("hello world!");
    File file = new File("D:\ideaM\test\src\main\java\com\manyun");

    // 检查目录是否存在且为目录
    if (!file.exists() || !file.isDirectory()) {
        System.err.println("目录不存在或不是有效目录: " + file.getAbsolutePath());
        return;
    }

    System.out.println("开始遍历目录...");
    traverseDirectory(file, 0);
    System.out.println("遍历结束");
}

目录遍历方法

/**
 * 递归遍历目录及其子目录中的所有文件
 * @param directory 要遍历的目录
 * @param level 当前目录层级（用于缩进显示）
 */
public static void traverseDirectory(File directory, int level) {
    // 创建缩进字符串以显示层级关系
    StringBuilder indent = new StringBuilder();
    for (int i = 0; i < level; i++) {
        indent.append("  ");
    }

    File[] files = directory.listFiles();
    if (files == null) {
        System.err.println(indent.toString() + "无法访问目录内容: " + directory.getAbsolutePath());
        return;
    }

    System.out.println(indent.toString() + "目录: " + directory.getName() + " (包含 " + files.length + " 项)");

    for (File file : files) {
        if (file.isDirectory()) {
            // 如果是目录，递归遍历
            System.out.println(indent.toString() + "子目录: " + file.getName());
            traverseDirectory(file, level + 1);
        } else {
            // 如果是文件，处理文件名替换
            System.out.println(indent.toString() + "文件: " + file.getName());

            // 将文件名中的"RedPacket"替换为"Points"
            String originalName = file.getName();
            if (originalName.contains("RedPacket")) {
                String newName = originalName.replace("RedPacket", "Points");
                File destFile = new File(file.getParentFile(), newName);
                boolean success = file.renameTo(destFile);
                if (success) {
                    System.out.println(indent.toString() + "  重命名成功: " + originalName + " -> " + newName);
                    // 更新file引用为重命名后的文件
                    file = destFile;
                } else {
                    System.err.println(indent.toString() + "  重命名失败: " + originalName + " -> " + newName);
                }
            }

            // 修改文件内容中的"RedPacket"为"Points"
            if (file.getName().endsWith(".java") || file.getName().endsWith(".txt") ||
                    file.getName().endsWith(".xml") || file.getName().endsWith(".properties")) {
                modifyFileContent(file, indent.toString());
            }
        }
    }
}

文件内容修改方法

/**
 * 修改文件内容中的"RedPacket"为"Points"
 * @param file 要修改的文件
 * @param indent 缩进字符串（用于日志输出）
 */
private static void modifyFileContent(File file, String indent) {
    try {
        // 读取文件内容
        String content = new String(Files.readAllBytes(Paths.get(file.getAbsolutePath())), StandardCharsets.UTF_8);

        // 检查是否包含"RedPacket"
        if (content.contains("RedPacket")) {
            // 替换"RedPacket"为"Points"
            String modifiedContent = content.replace("RedPacket", "Points");

            // 写入修改后的内容
            Files.write(Paths.get(file.getAbsolutePath()), modifiedContent.getBytes(StandardCharsets.UTF_8));

            System.out.println(indent + "  文件内容修改成功: " + file.getName());
        }
    } catch (IOException e) {
        System.err.println(indent + "  文件内容修改失败: " + file.getName() + " 错误: " + e.getMessage());
    }
}

使用指南

基本使用

1. 修改主方法中的目录路径为目标目录

2. 运行程序，开始遍历和替换操作

3. 查看控制台输出，了解处理进度和结果

自定义配置

如需修改替换规则，可调整以下部分：

• 文件名替换规则：修改traverseDirectory方法中的字符串替换逻辑

• 内容替换规则：修改modifyFileContent方法中的字符串替换逻辑

• 支持的文件类型：修改traverseDirectory方法中的文件扩展名判断条件

注意事项

1. 备份重要数据​：运行前请备份目标目录，此操作不可逆

2. 权限要求​：确保程序对目标目录有读写权限

3. 文件编码​：程序默认使用UTF-8编码处理文件，如遇特殊编码文件需调整

4. 大文件处理​：对于超大文件，可能需要优化内存使用方式

5. 并发访问​：处理期间确保没有其他程序正在访问目标文件

扩展建议

1. 可添加配置文件，使替换规则可配置化

2. 可增加正则表达式支持，实现更复杂的匹配规则

3. 可添加排除目录或文件的功能

4. 可增加批量撤销功能，方便回退操作

5. 可添加图形界面，提升易用性

示例输出

开始遍历目录...
目录: manyun (包含 15 项)
子目录: controller
  目录: controller (包含 3 项)
  文件: RedPacketController.java
    重命名成功: RedPacketController.java -> PointsController.java
    文件内容修改成功: PointsController.java
  文件: UserController.java
  子目录: model
...
遍历结束