File.listFiles() 返回 null 而非空数组，常见于权限不足、路径不存在或非目录，需判空再遍历；Windows 路径反斜杠需转义为“\”或用正斜杠；replaceAll() 第一参数是正则，字面量特殊字符须双重转义，简单替换应使用 replace()；renameTo() 静默失败，跨磁盘移动应改用 Files.move() 并捕获 IOException。
用 File 遍历目录时，为什么有些文件没被扫到？
因为 File.listFiles() 返回 null 而不是空数组——常见于权限不足、路径不存在或不是目录。不判空直接遍历会抛 NullPointerException。
- 永远先检查
files != null，再用for循环 - 递归遍历时，对每个
File对象都要调用.isDirectory()，别只靠后缀判断 - Windows 下路径含中文一般没问题，但若用
new File("D:data")，反斜杠会被当转义符，得写成"D:\data"或"D:/data"
String.replaceAll() 做正则替换，为什么结果不对？
因为 replaceAll() 第一个参数是正则表达式，不是普通字符串。比如想把文件名里的 "[old]" 换成 "[new]"，直接写 name.replaceAll("[old]", "[new]") 会把 o、l、d 当字符集匹配，全删掉。
- 要替换字面量方括号，得转义：
name.replaceAll("\[old\]", "\[new\]") - 如果只是简单字符串替换，用
String.replace()（非正则，参数是CharSequence）更安全 - 注意
replaceAll()返回新字符串，原字符串不变；重命名前必须用返回值构造新File
批量重命名失败，但没报错？检查这三件事
Java 的 File.renameTo() 是个“静默失败”的坑货：成功返回 true，失败（比如目标已存在、跨磁盘、权限不够）只返回 false，不抛异常。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 每次调用后必须检查返回值，
if (!file.renameTo(newFile)) { ... } - 目标文件已存在时，
renameTo()不覆盖，得先newFile.delete()（且确保删除成功） - 跨文件系统（如从 C: 到 D:）在 Windows 上基本失败，得改用
Files.move()（Java 7+）并加StandardCopyOption.REPLACE_EXISTING
用 Files.move() 替代 renameTo() 的实际写法
它更可靠，能抛出明确异常（如 AccessDeniedException），也支持原子移动和覆盖选项。
立即学习“Java免费学习笔记（深入）”；
- 路径要用
Path，不是File：Path source = Paths.get("a.txt"); Path target = Paths.get("b.txt"); - 必须捕获
IOException，不能忽略；常见错误信息如"Access is denied"、"The process cannot access the file"都说明文件被占用 - 推荐写法：
Files.move(source, target, StandardCopyOption.REPLACE_EXISTING, StandardCopyOption.ATOMIC_MOVE);（后者在支持的文件系统上更安全）
真正麻烦的从来不是正则或循环，而是重命名那一刻——文件是否被编辑器锁着、杀毒软件拦着、甚至 Explorer 正在预览缩略图。跑之前手动关掉资源管理器预览窗，比写十行容错代码还管用。
