Java 文件安全重命名与移动应优先使用 Files.move() 替代 renameTo()，配合异常处理、权限校验、原子语义及跨设备降级策略，并注意中文名、空格与编码问题。
Java 中实现文件的安全重命名与移动，核心在于避开 File.renameTo() 的静默失败缺陷，改用 Files.move() 并配合显式异常处理、权限校验和原子语义控制。安全不是“一次成功”，而是可验证、可回滚、失败有明确反馈。
优先使用 Files.move() 替代 renameTo()
File.renameTo() 返回 false 却不抛异常，跨文件系统时可能只删源不写目标，极易丢数据。而 Files.move()（NIO.2）默认抛出具体异常，便于定位问题：
- 加
StandardCopyOption.REPLACE_EXISTING明确覆盖语义，避免FileAlreadyExistsException - 加
StandardCopyOption.ATOMIC_MOVE强制原子性（仅同文件系统有效；跨设备会直接抛AtomicMoveNotSupportedException，不会静默降级） - 源和目标必须是
Path类型，不能混用File对象 - 示例：
Files.move(Paths.get("a.txt"), Paths.get("b.txt"),
StandardCopyOption.REPLACE_EXISTING, StandardCopyOption.ATOMIC_MOVE);
跨文件系统必须手动 copy + delete
当检测到跨设备（如从 /home 移到 /mnt/usb），Files.move() 会直接失败。此时需主动降级：
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 先用
Files.copy(source, target, REPLACE_EXISTING)复制，并用Files.size(source) == Files.size(target)校验完整性 - 复制成功后，再调用
Files.delete(source)（它会抛异常，比File.delete()可靠） - 若
delete失败，保留原文件并记录错误——不要自动二次删除 - 可用
Files.isSameFile(Files.getFileStore(src), Files.getFileStore(dst))判断是否同设备
批量操作前必须预检与建映射表
批量重命名上百个文件时，中间失败会导致状态不一致。安全做法是：
立即学习“Java免费学习笔记（深入）”；
- 预先构建
Map<path path></path>映射表，存好所有「旧路径 → 新路径」对 - 逐个检查：目标是否存在、父目录是否可写、源是否可读（用
Files.isReadable()/Files.isWritable()） - 执行时逐个
move()并捕获异常，记录失败项但不停止整个流程 - 全部尝试完后返回失败列表，供上层决定是否触发反向回滚（前提是未启用
REPLACE_EXISTING，否则无法还原）
中文名、空格与编码问题不能忽略
Windows 或旧 Linux 下，中文文件名乱码常因 JVM 默认编码非 UTF-8 导致：
- 启动命令加
-Dfile.encoding=UTF-8 - 用户输入新名时，统一用
new String(bytes, StandardCharsets.UTF_8)解码 - 提取文件名用
path.getFileName().toString()，别用String.split(" ")拆含空格的原始名 - 路径分隔符统一用正斜杠
/或双反斜杠\，避免单反斜杠转义
