0

0

在Java中如何实现文件批量重命名工具_JavaIO项目实战

P粉602998670

P粉602998670

发布时间:2026-01-23 14:08:02

|

974人浏览过

|

来源于php中文网

原创

最稳妥的批量重命名方式是逐个调用Files.move()并捕获IOException,传入StandardCopyOption.REPLACE_EXISTING,路径用Path类型,中文路径需统一JVM编码为UTF-8,并添加进度反馈与中断机制。

在java中如何实现文件批量重命名工具_javaio项目实战

Files.move() 批量重命名文件最稳妥

Java 标准库中真正可靠、支持跨文件系统且带原子语义的重命名操作,只有 Files.move()。别用 File.renameTo() —— 它在 Windows 上可能静默失败,在 Linux 上跨分区必失败,还不抛异常,只返回 false

批量处理时,必须逐个调用 Files.move(),并显式捕获 IOException。常见错误是把所有新文件名一次性生成后统一执行,结果中途出错导致状态不一致。

  • 始终传入 StandardCopyOption.REPLACE_EXISTING,否则目标文件已存在时直接抛 FileAlreadyExistsException
  • 源路径和目标路径必须都是 Path 类型,别混用 StringFile
  • 如果需按顺序重命名(如 img_001.jpg → img_002.jpg → img_003.jpg),要先重命名为临时名,再统一改回,避免覆盖

按规则生成新文件名:别硬拼字符串,用 String.format()MessageFormat

用户常要求“给所有 .log 文件加时间戳前缀”或“按序号重命名”,这时候手写 substring() + concat() 极易出错,尤其遇到中文路径、特殊符号或空格。

推荐用 String.format() 控制格式,比如补零序号:String.format("photo_%04d.jpg", index);若需更灵活的模板(如 {name}_backup_{yyyy-MM-dd}),用 MessageFormat 配合 SimpleDateFormat

立即学习Java免费学习笔记(深入)”;

注意:文件名中的非法字符(Windows 下的 : " / \ | ? *)必须提前过滤,否则 Files.move() 会直接抛 InvalidPathException

处理中文路径和编码问题:确保 JVM 默认编码与系统一致

在 Windows 中文系统下,如果用 IDE 启动(如 IntelliJ 默认用 UTF-8),而命令行终端是 GBK,Paths.get("测试文件.txt") 可能解析失败,报 java.nio.file.InvalidPathException: Malformed input or input contains unmappable characters

无限画
无限画

千库网旗下AI绘画创作平台

下载

这不是代码 bug,而是环境编码不一致。解决方式只有两个:

  • 启动 JVM 时加参数:-Dfile.encoding=UTF-8(推荐,一劳永逸)
  • 读取用户输入的路径字符串后,用 new String(input.getBytes(StandardCharsets.ISO_8859_1), StandardCharsets.UTF_8) 强制转码(仅限调试时救急)

别试图用 Charset.defaultCharset() 动态判断——它不可靠,且不同平台返回值不同。

真实批量场景必须加进度反馈和中断机制

处理几百个文件时,控制台光标不动容易让人误以为卡死。但 Java 没有内置进度条,简单做法是每处理 10 个文件输出一行日志:System.out.printf("已处理 %d / %d%n", processed, total);

更关键的是中断支持:用户按 Ctrl+C 时,应安全停止,而不是让部分文件已重命名、部分未处理。需注册 Runtime.getRuntime().addShutdownHook(),并在主循环中定期检查 Thread.interrupted()

下面是一个最小可运行的骨架示例:

Path dir = Paths.get("input");
List<Path> files = Files.list(dir)
    .filter(p -> p.toString().endsWith(".txt"))
    .sorted() // 确保顺序
    .collect(Collectors.toList());

for (int i = 0; i < files.size(); i++) {
    if (Thread.interrupted()) {
        System.out.println("已手动中断,共完成 " + i + " 个");
        break;
    }
    Path src = files.get(i);
    Path dst = dir.resolve(String.format("renamed_%03d.txt", i + 1));
    try {
        Files.move(src, dst, StandardCopyOption.REPLACE_EXISTING);
    } catch (IOException e) {
        System.err.println("失败: " + src + " → " + dst + ", 原因: " + e.getMessage());
    }
}

真正难的不是 rename 这一行代码,而是路径合法性校验、中断时的状态一致性、以及用户输入的任意性 —— 这些地方没做防护,工具上线后第一周就会被反馈崩三次。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1031

2023.08.02

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

888

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

463

2024.06.27

printf用法大全
printf用法大全

php中文网为大家提供printf用法大全,以及其他printf函数的相关文章、相关下载资源以及各种相关课程,供大家免费下载体验。

76

2023.06.20

fprintf和printf的区别
fprintf和printf的区别

fprintf和printf的区别在于输出的目标不同,printf输出到标准输出流,而fprintf输出到指定的文件流。根据需要选择合适的函数来进行输出操作。更多关于fprintf和printf的相关文章详情请看本专题下面的文章。php中文网欢迎大家前来学习。

306

2023.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1567

2023.10.24

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 10.6万人学习

Git 教程
Git 教程

共21课时 | 4.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号