Files.createDirectories() 是 Java NIO.2 中用于递归创建多层目录的方法，自动逐级创建缺失父目录，已存在则静默跳过，不抛 FileAlreadyExistsException，但权限不足或磁盘满时抛对应 IOException。
Files.createDirectories() 是 Java NIO.2 中专门用于递归创建多层目录的方法，它会自动检查并逐级创建路径中所有不存在的父目录，无需手动判断或循环调用。
核心行为：自动递归创建，不报错已存在
该方法接收一个 Path 对象，代表目标目录路径。它会从根开始，沿着路径逐级检查，对每一段缺失的目录调用 createDirectory()。如果某一级目录已存在（包括符号链接），它会静默跳过，不会抛出 FileAlreadyExistsException —— 这是它与 Files.createDirectory() 的关键区别。
- 路径中任意中间目录不存在？→ 自动创建
- 目标目录已存在？→ 不做任何操作，直接返回该
Path - 父路径不可写、磁盘满、权限不足？→ 抛出对应
IOException（如AccessDeniedException、IOException）
基本用法示例
假设要创建 /home/user/project/src/main/java/com/example/app，而其中 project 及其以下各级都不存在：
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class DirCreator {
public static void main(String[] args) throws Exception {
Path target = Paths.get("/home/user/project/src/main/java/com/example/app");
Files.createDirectories(target); // 一行搞定全部层级
System.out.println("目录已创建：" + target);
}
}
执行后，从 project 开始，直到 app，所有中间目录都会被创建。
配合文件操作的典型场景
实际开发中，常在写入文件前确保其所在目录存在。例如保存日志到 logs/2024/06/error.log：
- 先提取父目录：
Path logDir = Paths.get("logs/2024/06"); - 再创建：
Files.createDirectories(logDir); - 最后写文件：
Files.write(Paths.get("logs/2024/06/error.log"), content);
这样可避免因目录缺失导致 NoSuchFileException。
注意事项与常见问题
虽然方法简洁，但需注意几点：
-
不能创建文件：只处理目录。若路径末尾带扩展名（如
dir/file.txt），它仍尝试创建名为file.txt的目录，会失败 -
不处理相对路径歧义：传入
Paths.get("a/b/c")基于当前工作目录；建议用绝对路径或显式解析：Paths.get(".").toAbsolutePath().resolve("a/b/c") -
异常需捕获：推荐至少捕获
IOException，方便定位权限、空间或路径格式问题
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
