Java中修改文件名或路径应使用Files.move()（推荐）而非File.renameTo()，因前者更可靠、支持跨文件系统、异常明确；需确保目标父目录存在，并合理使用StandardCopyOption.REPLACE_EXISTING等选项。
Java 中修改文件名或目录路径，本质是将文件从旧路径移动（rename）到新路径。Java 提供了两种主流方式：传统 File 类的 renameTo() 方法，以及更推荐、功能更强的 Files.move()（NIO.2）。后者更可靠、支持跨文件系统、可精确控制行为，且能抛出明确异常便于排查。
使用 Files.move()（推荐，Java 7+）
这是现代 Java 中操作文件重命名/移动的标准做法。它基于 NIO.2，原子性强，支持选项控制，异常信息清晰。
-
基本用法（仅改名，同目录）：将
old.txt改为new.txt（在同一目录下）
Path target = Paths.get("data/new.txt");
Files.move(source, target, StandardCopyOption.REPLACE_EXISTING);
-
移动并重命名（改路径 + 改名）：把文件从
./input/file.log移到./output/archive_2024.log
Path target = Paths.get("output/archive_2024.log");
Files.move(source, target, StandardCopyOption.REPLACE_EXISTING);
- 关键注意事项：
- 目标父目录（如
output）必须已存在，否则抛NoSuchFileException；可用Files.createDirectories(target.getParent())提前创建 -
StandardCopyOption.REPLACE_EXISTING表示目标文件存在时直接覆盖（不抛异常） - 若需原子性且支持跨分区，部分系统可能回退为“复制+删除”，但行为由底层文件系统决定
- 操作失败会明确抛出
IOException及其子类（如AccessDeniedException、FileAlreadyExistsException），建议捕获处理
使用 File.renameTo()（兼容旧代码，不推荐新项目）
该方法简单但不可靠：在不同文件系统间可能失败、不抛异常而是返回 false、无错误原因提示，且无法覆盖已有文件（除非手动先删除）。
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 示例：
File newFile = new File("report_final.pdf");
boolean success = oldFile.renameTo(newFile); // 返回 true 才成功，否则静默失败
- 问题明显：
- 返回
false时，你不知道是权限不足、目标被占用，还是磁盘满 - 目标路径含不存在的父目录时，必定失败
- Windows 下对正在打开的文件 rename 通常失败；Linux 可能成功但原句柄仍有效
常见需求补充说明
-
批量重命名多个文件？遍历
Files.list(dir)，对每个Path构造新目标路径后调用Files.move() -
只改扩展名？用
fileName.replaceFirst("\.[^.]+$", ".bak")或Path的getFileName()+resolveSibling()组合构造新路径 -
确保安全（避免覆盖误删）？不加
REPLACE_EXISTING，先用Files.exists(target)判断，再决定跳过、重命名或提示用户 - 需要撤销操作？Java 标准库不提供“移动撤销”；业务层需自行记录源/目标路径，实现回滚逻辑
小结：选 Files.move()，别碰 renameTo()
除非维护非常老的 JDK 6 项目，否则一律使用 java.nio.file.Files.move()。它语义清晰、异常明确、行为可控。记住两点核心：确保目标父目录存在，合理选用 REPLACE_EXISTING 等选项。操作本身不复杂，但路径构造和异常处理容易忽略，写之前多检查几遍 Path 是否符合预期。
立即学习“Java免费学习笔记（深入）”；
