Files.createDirectory()

Java 7 引入了 java.nio.file 包，这是现代、强大且推荐的文件操作 API。Files 类提供了创建目录的方法。

创建单个目录

使用 Files.createDirectory(Path path) 方法。

关键点：

• 路径分隔符：虽然 Java 的 Path API 可以处理不同操作系统的路径分隔符（ 或 \），但在 Linux 环境下，使用正斜杠 是最标准和清晰的方式。
• 父目录必须存在：此方法要求路径中的所有父目录都必须已经存在，否则会抛出 NoSuchFileException。
• 目录已存在：如果目录已经存在，此方法会抛出 FileAlreadyExistsException。

示例代码：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class CreateSingleDirectory {
    public static void main(String[] args) {
        // 定义要创建的目录路径
        // 假设当前工作目录是 /home/user/myapp
        // 那么新目录将创建在 /home/user/myapp/logs
        Path path = Paths.get("logs");
        try {
            // 创建目录
            // 如果目录创建成功，此方法返回创建的 Path 对象
            Path newPath = Files.createDirectory(path);
            System.out.println("目录创建成功: " + newPath.toAbsolutePath());
        } catch (FileAlreadyExistsException e) {
            System.out.println("目录已存在: " + path);
        } catch (IOException e) {
            System.err.println("创建目录时发生错误: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

创建多级目录（包括所有父目录）

如果需要创建一个深层嵌套的目录结构（project/src/main/java），使用 Files.createDirectories() 方法。

关键点：

• 自动创建父目录：这是它与 createDirectory() 的最大区别，如果路径中的任何父目录不存在,该方法会自动创建它们。
• 幂等操作：如果目录（以及所有父目录）已经存在，它不会抛出异常，而是静默地成功执行,这使得它在脚本和初始化逻辑中非常安全和方便。

示例代码：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class CreateMultipleDirectories {
    public static void main(String[] args) {
        // 定义要创建的多级目录路径
        Path path = Paths.get("project/src/main/java/com/example");
        try {
            // 创建多级目录，如果父目录不存在会自动创建
            Path newPath = Files.createDirectories(path);
            System.out.println("多级目录创建成功: " + newPath.toAbsolutePath());
        } catch (IOException e) {
            System.err.println("创建多级目录时发生错误: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

最佳实践与注意事项

使用 try-with-resources 或 try-catch 处理异常

文件 I/O 操作可能会因为权限不足、磁盘已满、路径无效等原因失败，因此必须使用 try-catch 块来处理可能抛出的 IOException。

使用 Path 和 Files (NIO.2 API)

这是 Java 7 及以上版本推荐的方式，它比旧的 java.io.File API 更强大、更灵活，并且支持更高级的特性如符号链接、异步 I/O 等。

处理权限问题

在 Linux 中，你的 Java 进程需要有足够的权限在指定路径下创建目录。

• 检查权限：如果创建失败，首先确认运行 Java 程序的用户（tomcat, root, 或你的普通用户）对该父目录是否有 write (写入) 权限。
• 设置权限：Files.createDirectories() 默认会使用系统的默认权限（通常是 755 或 rwxr-xr-x），如果你需要设置特定的权限，可以使用 PosixFilePermissions 类。

示例：设置目录权限

import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.PosixFilePermission;
import java.util.HashSet;
import java.util.Set;
public class CreateDirectoryWithPermissions {
    public static void main(String[] args) {
        Path path = Paths.get("secure_folder");
        try {
            // 定义权限 (rwxr-x---)
            Set<PosixFilePermission> permissions = new HashSet<>();
            permissions.add(PosixFilePermission.OWNER_READ);
            permissions.add(PosixFilePermission.OWNER_WRITE);
            permissions.add(PosixFilePermission.OWNER_EXECUTE);
            permissions.add(PosixFilePermission.GROUP_READ);
            permissions.add(PosixFilePermission.GROUP_EXECUTE);
            // 创建目录并设置权限
            Files.createDirectories(path);
            Files.setPosixFilePermissions(path, permissions);
            System.out.println("目录创建成功并设置了权限: " + path.toAbsolutePath());
        } catch (UnsupportedOperationException e) {
            System.err.println("当前系统不支持 POSIX 文件权限。");
        } catch (IOException e) {
            System.err.println("操作失败: " + e.getMessage());
        }
    }
}

注意：PosixFilePermission 只在支持 POSIX 文件系统的操作系统上有效（如 Linux, macOS, FreeBSD），在 Windows 上运行会抛出 UnsupportedOperationException。

考虑原子性

Files.createDirectories() 不是原子操作，它首先检查路径是否存在，然后逐级创建目录，在极少数并发场景下，如果多个线程同时尝试创建相同的目录结构，理论上可能会出现问题，但对于绝大多数应用场景,这都不是问题。

完整示例：一个健壮的目录创建工具

下面是一个综合了上述所有要点的完整示例，它会创建一个目录,并处理各种边界情况。

import java.io.IOException;
import java.nio.file.*;
import java.util.Set;
public class RobustDirectoryCreator {
    /**
     * 创建一个目录，如果目录已存在则不做任何操作。
     * 如果父目录不存在，会自动创建。
     * 如果失败，会打印错误信息。
     *
     * @param dirPathStr 要创建的目录的路径字符串
     * @return 如果目录已存在或创建成功则返回 true，否则返回 false
     */
    public static boolean createDirIfNotExists(String dirPathStr) {
        if (dirPathStr == null || dirPathStr.trim().isEmpty()) {
            System.err.println("路径不能为空。");
            return false;
        }
        Path path = Paths.get(dirPathStr);
        // 检查目录是否已存在
        if (Files.exists(path)) {
            if (Files.isDirectory(path)) {
                System.out.println("目录已存在: " + path.toAbsolutePath());
                return true;
            } else {
                System.err.println("路径已存在但不是一个目录: " + path.toAbsolutePath());
                return false;
            }
        }
        try {
            // 创建多级目录
            Files.createDirectories(path);
            System.out.println("目录创建成功: " + path.toAbsolutePath());
            return true;
        } catch (IOException e) {
            System.err.println("创建目录 '" + path + "' 失败，原因: " + e.getMessage());
            // 你可以在这里添加更详细的错误处理逻辑，例如检查权限
            if (e instanceof AccessDeniedException) {
                System.err.println("错误: 没有足够的权限，请检查运行用户权限。");
            }
            return false;
        }
    }
    public static void main(String[] args) {
        // 示例 1: 创建一个简单的目录
        createDirIfNotExists("logs");
        System.out.println("--------------------");
        // 示例 2: 创建一个复杂的多级目录
        createDirIfNotExists("project/src/main/resources");
        System.out.println("--------------------");
        // 示例 3: 尝试创建一个已存在的目录
        createDirIfNotExists("logs");
        System.out.println("--------------------");
        // 示例 4: 尝试创建一个无效路径（尝试在一个不存在的父目录下创建文件）
        // 这会失败，因为路径 "invalid_parent/my_file" 指向一个文件，但 createDirectories 只能创建目录
        Path invalidPath = Paths.get("invalid_parent/my_file");
        try {
            Files.createDirectories(invalidPath);
        } catch (IOException e) {
            // 预期的行为
            System.err.println("预期错误: " + e.getMessage());
        }
    }
}

对于绝大多数在 Linux 上运行的 Java 应用程序，Files.createDirectories() 是创建文件夹最简单、最安全、最推荐的方法。