讲师中心 微信公众号
AI工具推荐 视频效率加速

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

落静吖_9457

落静吖_9457

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

|

1014人浏览过

|

来源于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

onewo-rtlinux
onewo-rtlinux

Linux 实时编程助手。生成、审查并修改用于周期性控制任务和中断驱动程序的 C 代码。强制实施实时调度策略。

下载

这不是代码 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工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

更多
Java I/O 与 NIO 编程体系合集
Java I/O 与 NIO 编程体系合集

全面讲解 Java I/O 编程的演进与核心 API,涵盖传统 I/O 的字节流(InputStream/OutputStream)与字符流(Reader/Writer)体系、装饰器模式在 I/O 中的应用(BufferedReader/InputStreamReader)、文件读写与目录操作、NIO 核心三要素(Buffer 缓冲区/Channel 通道/Selector 选择器)、ByteBuffer 操作与内存映射文件(Mappe

312

2026.04.29

string转int
string转int

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

5099

2023.08.02

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

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

1569

2023.07.31

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

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

1191

2024.06.27

printf用法大全
printf用法大全

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

608

2023.06.20

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

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

989

2023.11.28

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

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

1518

2023.08.03

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

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

2204

2023.09.04

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn