批量修改文件后缀名与命名规范需递归遍历、安全重命名并处理冲突:一、仅改后缀用files.walk+files.move,保留文件名主体;二、按规则重命名需正则提取+日期格式化+存在性检查;三、须跳过隐藏/占用/关键文件,支持预览模式与备份;四、建议封装工具类统一接口。

批量修改指定目录下所有文件的后缀名与命名规范,核心是遍历文件、重命名(含扩展名替换)并确保不覆盖、不误操作。关键在于区分“仅改后缀”和“整体重命名”,同时处理子目录、特殊字符、大小写、冲突等问题。
一、只改后缀名(如 .txt → .log)
这是最常见需求,比如统一日志文件格式。注意:不能直接 renameTo(),需用 Files.move() 保证跨文件系统兼容性;且必须保留原文件名主体,仅替换扩展名。
- 使用 Files.walk() 递归遍历目标目录(含子目录),跳过目录本身
- 对每个普通文件,用 Path.getFileName().toString() 获取完整文件名,用 lastIndexOf('.') 定位旧扩展名位置
- 构造新路径:用 subpath(0, path.getNameCount()-1) 获取父路径,再拼接新文件名(如 oldName.substring(0, dotIndex) + ".log")
- 调用 Files.move(oldPath, newPath, StandardCopyOption.REPLACE_EXISTING) 完成重命名
- 务必捕获 IOException 并记录失败文件,避免中断整个流程
二、按规则重命名(如 “report_20240501.txt” → “daily-2024-05-01.log”)
这需要解析原始文件名、提取信息、按模板重组。建议先定义命名规则(正则提取 + DateTimeFormatter 格式化日期),再生成新名。
- 用 Pattern.compile("report_(\d{8})\.txt") 匹配并提取日期字符串
- 将 "20240501" 解析为 LocalDate,再用 DateTimeFormatter.ofPattern("yyyy-MM-dd") 格式化
- 组合新名:"daily-" + formattedDate + ".log"
- 检查新路径是否已存在——若存在,可加序号后缀(如 daily-2024-05-01-1.log)或跳过
- 推荐把重命名逻辑封装为函数,输入旧 Path,返回 Optional
表示成功的新路径
三、安全与边界处理不可省略
真实场景中,疏忽这些会导致数据丢失或脚本崩溃。
- 跳过隐藏文件和系统文件:filter(p -> !p.getFileName().toString().startsWith("."))
- 排除正在被占用的文件:try-catch AccessDeniedException 或 FileSystemException
- 禁止修改自身脚本或配置文件:提前白名单过滤(如跳过 ".jar", "config.properties")
- 预览模式开关:加 boolean dryRun 参数,只打印将执行的操作,不实际 move
- 备份原文件? 生产环境建议先 copy 再删除,或重命名前加 .bak 后缀(如 file.txt → file.txt.bak)
四、简化工具类封装建议
避免每次重复写 walk + filter + move。可封装一个工具类:
- BatchRenamer.renameByExtension(Path dir, String oldExt, String newExt)
- BatchRenamer.renameByPattern(Path dir, Pattern pattern, Function
newNameFunc) - 所有方法接受 boolean skipIfExists 和 Consumer
logger 参数 - 返回 int count(成功数)和 List
errors (失败详情)
不复杂但容易忽略细节。动手前先在测试目录跑 dryRun,确认输出符合预期再执行真实操作。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











